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PREFACE 


Manual Objectives 


PRO/GIDIS is one of the tools you can use to develop graphics 
applications for the Professsional. This manual is both a user’s 
guide and a reference manual for PRO/GIDIS, the General Image 
bisplay Instruction: Set. It explains how to use PRO/GIDIS and 
describes each instruction in detail. It provides information 
about device-independent text and graphics programming with 
PRO/GIDIS. 


Intended Audience 


You should read this manual if you are developing a graphics 
application for the Professional and need information about 
PRO/GIDIS-: 


This document is intended for programmers who have had experience 
with systems programming and graphics applications software. You 
Should also have experience with either MACRO-11 or FORTRAN. 


This document explains how to use PRO/GIDIS on both the P/OS and 
RT-11 operating systems. All chapters except 4 and 5 apply to 
both operating systems. If you are using P/OS, read Chapter 4; 
if you are using RT-11, read Chapter 5. 


Structure of This Document 

This document has six chapters and eight appendixes. 

Chapter 1, Imtroduction to. PRO/GIDIS, ‘describes PRO/GIDIS. and 
places it in the context of other graphic tools. It provides 
guidelines so that you can determine whether to use PRO/GIDIS or 


some other graphics software. 


Chapter 2, Understanding PRO/GIDIS, provides a conceptual 


framework for PRO/GIDIS. It explains key terms and introduces 
GIDIS instructions. Together with Chapter 4 (for P/OS), or 
Chapter 5 (for RT-11), this chapter serves as a user’s guide. 


Chapter 3, PRO/GIDIS Syntax, describes the GIDIS instruction 
syntax, which. isthe same for PyvOS and RI=-11. 


Chapter 4, Using PRO/GIDIS with P/OS, explains how to use 


1x 


PRO/GIDIS with P/OS, the Professional Operating System. The 
chapter describes the GIDIS Call Interface (GIDCAL), the devices 
accessed by GIDCAL, and error handling. 


Chapter 5, USing PRO/GIDIS with RT-11, describes how to use 
PRO/GIDIS with the RT-11 operating system. The chapter describes 
three interfaces (including GIDCAL) and error handling. 


Chapter 6, PRO/GIDIS Instructions, lists each GIDIS instruction 
in alphabetical order for quick reference. Information includes: 
format, arguments, notes explaining how the instruction works, 
and examples. 


Appendix A, PRO/GIDIS Instruction Summaries, lists each PRO/GIDIS 
instruction, its operation code (opcode), argument length, opcode 
word, and associated arguments. Instructions are grouped _ two 
ways: by opcode and in alphabetical order. 


Appendix B, DEC Multinational Character Set, shows the code table 
for the Professional’s alphabet 0, the DEC Multinational 
Character Set. 


Appendix C, Font File Format, describes the font file format 
required by the LOAD_BY_NAME instruction. 


Appendix D, Managing Fonts, describes how to tell the font server 
about your font files. 


Appendix E, Area Texture and Color on the Plotter, describes how 
Plotter GIDIS processes instructions that affect area texture and 


color. 

Appendix F, Alternate Access to Video GIDIS, explains the Queue 
I/O Request (QIOS) and Queue I/O Request and Wait (QIOWS) system 
directives for P/OS. This access method is documented for 
backward compatibility with earlier versions. 


Appendix G, Glossary, defines key terms used in this manual. 


Associated Documents - P/OS 
@ CORE Graphics Library Manual 
e P/OS System Reference Manual 


@® RMS-11 Macro Programmers Guide 


@® PRO/Document VDM Manual 


® Tool Kit Language Manuals 


Associated Documents - RT-11 


@® RT-11 Programmer’s Reference Manual 


Conventions Used in This Document 


Convention/Term 


[optional ] 


UPPERCASE 


lowercase 


TOOL, Kit 


Host Tool Kit 


PRO/Tool Kit 


Meaning 


In a command line, square brackets indicate 
that the enclosed item is optional. Ina file 
Specification, square brackets are part of 
the required syntax. 


Uppercase words and letters indicate that you 
should type the word or letter exactly as 
shown. 


Lowercase words and letters indicate that you 
Should substitute a word or value of your 
own. Usually the lowercase word identifies 
the type of substitution required. 


A horizontal ellipsis indicates that you can 


repeat the preceding item one or more’ times. 
For example: 


Darameter |,parameter..4.] 

A vertical ellipsis means that not all of the 
statements are shown. 

Interactive input appears in red. 

This general term refers to the software you 
use to develop applications to run on a 
Professional computer. 

The Host Tool Kit is Tool Kit software that 
runs on a host computer, rather than on the 


Professional itself. 


The PRO/Tool Kit is the Tool Kit software 
that runs on the Professional computer. 
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CHAPTER 1 
INTRODUCTION TO PRO/GIDIS 


PRO/GIDIS, the General Image Display Instruction Set, is one of 
several tools used to develop graphics applications for the 
Professional 300 Series computer. It consists of a set of 
instructions that provide the lowest-level, virtual device 
interface to the Professional’s graphics hardware. 


1.1 USES OF PRO/GIDIS 


PRO/GIDIS is aimed at applications creating compass and ruler 
graphics, those in which images can be described using 
geometrical entities such as lines, arcs, and shaded areas. You 
can also use PRO/GIDIS to display mixed text and graphics. 
Figure 1-1 shows typical PRO7GLDIS output, a graphical 
representation of some sample statistical data. 
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Figure 1-1: PRO/GIDIS Sample Output 
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USES OF PRO/GIDIS 


PRO/GIDIS is the lowest layer of software that receives’ and 
interprets graphics instructions in a device-independent way. 
When the current output device cannot fully Support an 
instruction, GIDIS provides an appropriate fallback. 


With GIDIS under P/OS, you can write on a number of devices. 
Among them are the Professional video monitor, the LVP16 plotter, 
and various printers (the LN03, LA50 and LA100). You can also 
store GIDIS instructions in a file and later print the stored 
picture, either by itself or as part of a document. Under RT-11, 
you can write only on the video monitor. 


The GIDIS Call Interface (GIDCAL) provides uniform access to each 
device supported by GIDIS. It also simplifies access to GIDIS 
from high-level languages. 


1.2 RELATIONSHIP TO OTHER P/OS GRAPHICS TOOLS 


PRO/GIDIS provides the foundation for several other graphics 
tools on the Professional. Because these tools are implemented 
as layers above PRO/GIDIS, each tool sets GIDIS attributes and 
expects to be in full control of them. As a result, use of more 
than one graphics protocol within an application is not 
supported. 


Other graphics tools include: 


@® The PRO/Tool Kit CORE Graphics Library (CGL), a library of 
high-level graphics subroutines based on the ACM SIGGRAPH 
CORE Standard. 


@® ReGIS (Remote Graphics Instruction Set), a DIGITAL-developed, 
ASCII-based protocol, is used to transmit graphics 
instructions from a host computer to a remote Professional, 
VT125, VT240 or GIGI graphics terminal. A ReGIS to GIDIS 
converter (RTOG) translates ReGIS data files to GIDIS files 
that can be displayed (or printed) on the Professional. 

ReGIS currently cannot be used by applications that reside on 
the Professional itself; it can only be used in terminal 
emulation mode. 


@® NAPLPS, North American Presentation Level Protocol Syntax, is 
an ASCII-based protocol developed for Videotex/Teletext. 
NAPLPS currently cannot be used by applications that reside 
on the Professional itself; it can only be used in terminal 
emulation mode. 


RELATIONSHIP TO OTHER P/OS GRAPHICS TOOLS 


@ TEK 4014 is an industry-standard Tektronix-based software 
protocol adapted from storage tube technology. TEK 4014 is 
available as a third party application that runs on the 
Professional only in terminal emulation mode. 


@® PRO/Document VDM, not a graphics tool itself, is the layer of 
P/OS that enables you to integrate graphics into documents. 


Figure 1-2 shows the relationship between PRO/GIDIS and other 
Graphire. tools. 
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Figure 1-2: PRO/GIDIS Interface 


RELATIONSHIP TO OTHER P/OS GRAPHICS TOOLS 


1.2.1 When to Use PRO/GIDIS 


Sometimes your choice of a graphics tool is a matter of taste, 
but there are some guidelines to go by. 


@ Use PRO/GIDIS if you want uniform access to the 
Professional’s graphic devices. 


@ Use PRO/GIDIS if execution speed is most important. 


@® Use PRO/GIDIS to implement graphics utility layers, like 
CORE, or tools rather than applications. 


1.2.2 When Not to Use PRO/GIDIS 
Do not use PRO/GIDIS under the following conditions: 


e If your program requires support for real (floating point) 
coordinates, curves, markers, and so forth, use the CORE 
Graphics Library. 


e If you are concerned with portability of programs and 
industry-standard program interfaces to graphics routines, 
use the CORE Graphics Library. 


e If you require VT100 or vT200 compatibility, use ReGIS with 
the Professional Terminal Emulator. 


CHAPTER 2 
UNDERSTANDING PRO/GIDIS 


This chapter begins by briefly describing concepts in graphic 
programming. It then relates these concepts to GIDIS. Finally, 
it summarizes the types of instructions available in GIDIS. 


2.1 INTRODUCTION TO GRAPHIC PROGRAMMING 
Graphic systems typically provide the following functions: 


@e Viewing Transformation Instructions. These enable you to 
define your drawing area in coordinate units that are 
convenient for your application, then map the units to a 


device-independent coordinate system for displaying the 
image. 


e® Interactive Control Instructions. These enable you to 
interactively control how an image displays on a view 
surface. You can modify how a picture is mapped to a view 
surface, define cursors, scroll data, and output an image. 


@e Drawing Instructions. These enable you to draw figures 
within a picture. 


e Attribute Instructions. These enable you to specify how the 
image appears when it displays. 


The following sections describe the main functions and introduce 
terms commonly used in graphic programming. 


INTRODUCTION TO GRAPHIC PROGRAMMING 


2.1.1 Viewing Transformation Instructions 


Two-dimensional graphic programming packages allow you to draw 
pictures ina Cartesian coordinate system, similar to drawing on 
graph paper. Most graphics systems allow you to define 
coordinate units that suit your particular application. Think of 
it as choosing graph paper with different scales, for example ten 
Squares per inch versus fifteen squares per inch. These units 
are purely logical coordinates whose range is limited only by the 


arithmetic limits of the processor. Some systems allow floating 
point coordinates; others allow only integers. You draw pictures 
in user coordinate units that you define. All drawing 


instructions are stored in a database in user coordinates units. 
This user coordinate system iS sometimes called the World 
Coordinate System. 


Besides allowing you to create and store graphic data, a graphics 
system must have a way of displaying the contents of the 
database. (Display 1S used ina generic sense to include output 
to any device, not just screen display.) Because graphic output 
is displayed on a variety of output devices, a graphics system 
must have a way of mapping the user coordinates to a view 
surface. While a video monitor may be the most common view 
surface, printer and plotter output can also be considered a view 
surface. 


The variety of output devices, both their shape and resolution, 
makes it desirable to have a device-independent way of describing 


the view surface. Hence, most graphics systems have a display 
coordinate system to describe the view surface. These coordinate 
system is sometimes called Normalized Coordinate Space. The 


exact way of defining the coordinate units within normalized 
space differs among graphic systems, but most allow you to choose 
coordinate units appropriate for any output device. 


NOTE 


To avoid confusion, this manual refers to 
operations performed in user coordinates as 
drawing a picture. It refers to operations 
performed in display coordinates as displaying an 
image. 


Each graphic system performs the computations necessary to map 
the contents of the user coordinate system to the display 
coordinate system. This process of mapping from the user 
coordinate system to the display coordinate system is called the 
viewing transformation. However, the way the mapping proceeds 
differs from system to system. For example, when some graphic 
systems map the picture to the displayed image, distortion 
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INTRODUCTION TO GRAPHIC PROGRAMMING 


results. Other systems preserve the shape of the picture. Some 
systems supply device drivers to complete the mapping in a way 
that preserves the image and suits the hardware requirements of 
the displaying device. 


2.1.2 Interactive Control Instructions 


Besides the standard viewing transformation operation, most 
systems provide interactive control instructions for modifying 
the mapping and manipulating the display. 


Graphics systems differ in how much control they give you over 
the mapping process, for example controlling the size and shape 
of the displayed image. An explanation of how a graphics system 
gives you control over mapping requires the introduction of 
several more terms. 


We refer to the entire contents of graphic data in the user 
coordinate space as a picture. You can map the entire picture to 
the view surface, or you can map only a portion of the picture to 
the view surface. You choose which portion to map by defining a 
window, a rectangular extent within the user coordinate space. 
By defining a window the same size as the picture, you map the 
entire picture to the view surface. By defining a window smaller 
than the picture, you map only a portion of the picture to the 
view surface. Only data within the defined window maps to the 
view surface. Anything outside the window is clipped. It 
remains in the picture, but is not displayed in the image on the 
view surface. 


On the view surface, the image displays in a rectangular area 


called the viewport. The viewport is defined in display 
coordinates. Graphics systems allow you to define the viewport 
in a number of ways. For example, you can fill an entire view 
surface, providing you define your viewport as having the same 
shape as the output device. Or you can change the size and 
placement of a viewport. In some graphics systems, you’ can 


display more than one viewport simultaneously. 


Because of all the options available both in defining the window 
and the viewport, mapping from user coordinates to display 
coordinates allows for many possibilities. You can, for example, 
define user and display coordinates to be identical and map an 
entire picture (the window encompasses the entire picture) to the 
entire viewport (which may or may not fill the display surface, 
depending on the shape of the viewport in relation to the shape 
of the display surface). Or you can define a window that 
includes only part of the picture, and map it to a larger 
viewport. This results in enlarging the image. Conversely, if 


223 


INTRODUCTION TO GRAPHIC PROGRAMMING 


you define the window as larger than the picture and map it to a 
smaller viewport, you reduce the image. Besides affecting the 


size, enlarging or reducing the image also affects the 
granularity of the image. 


Figure 2-1 shows several mapping possibilities. Each case 
assumes a viewport that covers the entire view surface. 


VIEWPORT 


WINDOW 


WINDOW, CLIPPING RECTANGLE, AND VIEWPORT SAME SIZE. 
NO CHIPPING: OF PICTURE. 


VIEWPORT 


WINDOW 


WINDOW SMALLER THAN VIEWPORT, IMAGE ENLARGED, PICTURE CLIPPED. 


VIEWPORT 


WINDOW 
WINDOW LARGER THAN VIEWPORT, IMAGE REDUCED, NO CLIPPING OF PICTURE. 
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Figure 2-1: Window to Viewport Mapping Options 
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Besides controlling mapping, graphics systems may also include 
instructions for using cursors or rubber bands to mark the 
current location. Other interactive control instructions enable 
you to erase, scroll, display, or print an image. 


2.1.3 Drawing Instructions 


Graphics systems provide you with building blocks to create a 


picture. These building blocks are called output primitives. 
Most systems have instructions for drawing points, lines, arcs, 
circles and text. Some also have instructions for filling 
figures, both closed and open figures. You Dbiuidd: “pietures.. by 


selecting appropriate drawing instructions. 


2.1.4 Attribute Instructions 


Graphics systems have attribute instructions that enable you to 


control how graphic output appears. Some attributes, like 
foreground and background color, affect all graphic output. Such 
attributes are called global attributes. Others affect only 
certain types of instructions, for example drawing lines. or 
drawing text. These are typically called line attributes and 
text attributes, respectively. In most graphics systems, 
attributes are modal, that is they remain in effect until you 


explicitly change them. 


2.2 INTRODUCTION TO GIDIS INSTRUCTIONS 


GIDIS has the types of instructions common to most graphics 
systems, plus additional instructions for fonts and reports. 
This chapter describes GIDIS instructions in the following 
functional groupings: 


e Picture Management Instructions. These provide the framework 
for creating and storing pictures, and for mapping them to an 
output device. 


@® Interactive Control Instructions. These include instructions 
for modifying the mapping process and manipulating the 
dusplay. 

e Drawing Instructions. These enable you to draw figures. 
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@e Attribute Instructions. These enable you to specify how the 
figure appears when it displays. 


@ Alphabet and Font Instructions. These allow you to create 
alphabets and fonts. 


@ Report Instructions. These enable you to check the state of 
GIDIS. 


2.2.1 Picture Management Instructions 


Picture Management instructions provide a framework for defining 
pictures and set up the viewing transformation. 


Because GIDIS attributes remain in effect until changed, you must 
include your specifications for the viewing transformation and 
all attributes in any picture you draw. The recommended way to 
do this is to frame all instructions for a given picture between 
a BEGIN_PICTURE and an END_PICTURE instruction. 


In general, you use the Picture Management instructions as 
follows: 


1. Use BEGIN_PICTURE to initiate definition of a picture. 


2. You can use an INITIALIZE -1 next. This initializes GIDIS to 
its default values (see INITIALIZE in Chapter 6). Although 
it 1S more work, it is better practice to explicitly 
initialize each GIDIS attribute to a value of your own 
choice. 


3. Set up an appropriate address space with SET_OUTPUT_IDS. 
Define coordinate values that are convenient for your 
application. 


4. To control the appearance of your output, you should also set 
up the color map with SET_COLOR_MAP_ENTRY. 


5. At this point you can use GIDIS attribute instructions and 
drawing instructions in any order you choose. 


6. When you have finished, terminate the picture definition with 
an END_PICTURE. 


The following paragraphs describe the GIDIS user and display 
coordinate spaces and how pictures are mapped to a view surface. 
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In GIDIS the user coordinate space is called GIDIS Output Space 
(GOS). GOS units are limited to integers. The origin of GOS is 
the upper left-hand corner of the coordinate space. The pixel 
aspect ratio of X coordinate units to Y coordinate units is 1:1. 
All GIDIS instructions except SET.OUTPUT. 1DS and 
SET_OUTPUT_VIEWPORT refer to GOS coordinates. You draw pictures 
and store them in GOS units. However, unless you use. the 
Interactive Control instructions to alter the mapping process, 
you do not directly define a window in GOS coordinates. 
SET_OUTPUT_IDS defines the window and controls the mapping. 


In GIDIS the display coordinate space is called Imposed Device 
Space (IDS). Like GOS, the units are limited to integers, the 
origin is the upper left-hand corner of the coordinate space, and 
the pixel aspect ratio is 1:1. The left edge of the display 
Surface 1s called the Y axis, and the top edge of the surface is 
called the xX axis. You determine the extent of IDS by the 
coordinates you choose for the lower right-hand corner. You 
assign values to the bottom right-hand corner of the view surface 
Wit SET OUTPUT IDSs. 


You must always use a SET_OUTPUT_IDS instruction to set up a 
device- independent address space for displaying your image. 
SET_OUTPUT_IDS implicitly performs several other functions. 


e It sets GIDIS Output Space (GOS) such that IDS and GOS units 
are identical. This means that the picture in GOS maps to 
the image in IDS identically. 


e It sets your viewport to the entire view surface as defined 
by IDS. Your viewport is the rectangle (defined in IDS) 
within which the image is displayed on the view surface. 


@ It sets the clipping rectangle to the entire view surface as 
defined by IDS. The clipping rectangle is the window 
(defined in GOS) that contains the picture you want to map to 
the viewport. Thus, the window and viewport are identical. 


The ability to define IDS in any coordinate units you choose 
allows you to control how your image displays in a 
device-independent way. Each output device has a certain shape 
(picture aspect ratio), resolution (number of physical pixels 
horizontally and vertically), and pixel aspect ratio (shape of 
physical pixel). These are hardware dependent. We call this 
hardware-dependent view Hardware Address Space (HAS). For 
example, the Professional 350 video has a shape of 8 x 5 inches, 
a resolution of 960 horizontal by 240 vertical hardware pixels, 
and a pixel aspect ratio of 1:2.5. Because each X unit 1s not 
equal to each Y unit, the HAS is anisotropic. This means that 
you cannot map a coordinate system using a 1:1 ratio to the 
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Professional video without performing calculations to compensate 
for the distortion that would otherwise occur. The driver 
supplied for each of the supported output devices performs these 
adjustments. 


YOU Can. Choose, if you like; ‘to. taidor “IDS for a -particular 
output device. For example, if you want your image to fill the 
view surface, assign coordinate values that reflect the shape of 
the view surface. For example, if the view surface were 8 units 
wide by 5 units high, you might set [X,Y] of the bottom right 
corner we. [79,49] or [799,499] or [(959,599}. All these 
coordinates would fill the view surface and maintain the same 
Shape. The only difference would be in the resolution. The more 
logical pixels (expressed in higher X and Y values), the finer 
the resolution of your drawing. In many cases, you will want to 
Use “Che entire Gisplay surtace. 


If the shape you give IDS does not match the shape of the 
device’s view surface, GIDIS starts at the upper left corner and 
maps as much as it can, leaving space on the bottom or to the 
right as necessary to maintain the proportions of your picture. 
This is why IDS is called device independent. 


Figure 2-2 shows an example of a square IDS shape (with arbitrary 
coordinates of (500,500) that does not fill the view surface of 
an 8 by a 5-inch video display. 


HAS 8 in 
SE ae tae aptee Mee Se ee ee ee 


IDS 500 


HAS 


ope 5 in 
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Figure 2-2: IDS Mapped onto a View Surface 
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You can use all picture management instructions either 
interactively or store them in a .GID file. 


Table 2-1 lists the Picture Management instructions. 


Table 2-1: Picture Management Instructions 


Instruction Action 

NEW _PICTURE Indicates the beginning of a new 
picture: 

END PICTURE Indicates the end of a picture. 


Action depends on device. 


INITIALIZE Returns GIDIS to its power-up 
state. Aborts character, filled 
figure and picture definition 
blocks. 


Sot OUTPUT. IDS Specifies the coordinate units 
and shape of the image that 
displays on the view surface. 
Implicitly sets GOS, the clipping 
rectangle, and the viewport to be 
identical with IDS. 


SET COLOR _MAP_ ENTRY Sets red, green, blue mixture for 
the specified color map entry. 


2.2.2 Interactive Control Instructions 


These instructions control drawing operations within an 
interactive environment. Consequently, these instructions are 
inappropriate in a .GID file, a stored picture. Most interactive 
environments presume a video display. 


INTRODUCTION LO: GiDTS: INSTRUCTIONS 


Interactive applications should allow you to modify the display 
quickly and easily. GIDIS has interactive control instructions 
for modifying how an existing picture displays on the view 
surface and for drawing new pictures. When drawing new pictures, 
you need to be able to mark the current position, erase, scroll, 
output the picture to a view surface, and make a hard copy of the 
displayed image. 


Several instructions control how an existing picture maps to a 
view surface. GIDIS allows you to display only part of a picture 
or change the size and location of your viewport. 


If you want to display only a part of picture, use 
SET_GIDIS_OUTPUT_SPACE to define a coordinate extent smaller than 
the picture. This is useful to blow up a portion of a picture. 
For complete details, see SET_GIDIS_OUTPUT_SPACE in Chapter 6. 


Tf you want to draw on only part of the view surface, use 
SET_OUTPUT_VIEWPORT to specify the size and location of your 
viewport. You can also specify multiple viewports and map a 
separate picture into each. For details, see Chapter 6. 


Normally, your clipping rectangle equals your viewport. 
(SET OUTPUT_IDS, SET _GIDIS_OUTPUT_SPACE, and SET_OUTPUT_VIEWPORT 
all set the clipping rectangle to match your viewport.) However, 
you can use SET_OUTPUT_CLIPPING_REGION to make your clipping 
rectangle smaller than your viewport. You might do this if you 
want to display a picture (or part of a picture) within a 
rectangle smaller than your viewport. 


If you want to clear a rectangle within your viewport, set the 
clipping rectangle to the desired size and use 
BRASE_CLIPPING_REGION. 


When using Video GIDIS, you may want to scroll (vertically or 
horizontally) whatever has been drawn within your clipping 
rectangle. Use SCROLL _CLIPPING_REGION to do this. The cleared 
Space reverts to the current secondary color. Data scrolled out 
may not be scrolled back in; it must be redrawn. 


While drawing a new picture with Video GIDIS, you may want to 
mark the current position. GIDIS gives you the option of using a 
cursor or rubber band to mark the current position. See 
SET_OUTPUT_CURSOR and SET _OUTPUT_RUBBER_BAND in Chapter 6. Lou 
select whether the cursor or rubber band blinks or 1S continuous 
with SET _OUTPUT_CURSOR_RENDITION. 


When you want your application to execute all pending drawing 
LNSstruce rons and prompt a user for further input, use 
FLUSH BUFFER. 
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With the Professional 380 video, you can work with several 
pictures at atime. SET_OUTPUT_BITMAP enables you to draw up to 
four pictures (two in high resolution mode) in separate pages of 
the video bitmap. You can quickly move among them. 


While drawing, you may want to print all or some portion of the 
video bitmap. PRINT_SCREEN allows you to send a specified 


portion of the video bitmap to a sixel printer connected to _ the 
Printer pore. 


Table 2-2 summarizes the GIDIS Interactive Control Instructions. 


Table 2-2: Interactive Control Instructions 


Instruction Action 


SET_GIDIS_OUTPUT_SPACE Specifies the coordinate units 
and shape of a window you define 
in GOS. Sets the clipping 
rectangle to coincide with the 
window. 


SET_OUTPUT_VIEWPORT Specifies the size and location 
of your viewport. 


SET OUTPUT CLIPPING REGION Specifies the rectangle on the 
view surface where GIDIS can 
draw. 

ERASE CLIPPING REGION Clears clipping rectangle. 

SCROLL CLIPPING _ REGION In Video GIDIS, scrolls data 


within clipping rectangle: 


SET_OUTPUT_CURSOR Specifies the type of cursor used 
to mark the current position. 


SET_OUTPUT_RUBBER_BAND Specifies the type of rubber band 
used to mark the current 
POSTELON.. 


SET _OUTPUT_CURSOR_RENDITION Selects whether the cursor or 
rubber band blinks or is 
continuous. 
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Instruction Action 

FLUSH _BUFFER Executes any pending GIDIS 
ImMsStructi.ons. 

SET OUTPUT BITMAP Selects bitmap on which to draw 


or display. (Professional 380 
video only) 


PRINT SCREEN Sends a specified portion of the 
video bitmap to a sixel printer 
connected to Che: printer port. 


2.2.3 Drawing Instructions 


GIDIS supplies the graphic primitives to draw lines, arcs, filled 
figures and text. You draw all pictures in GOS coordinates. 


GIDIS drawing instructions can specify coordinates in either 
absolute or relative terms. Absolute terms are Simply the X and 
Y coordinates you designate. Relative terms are in relation to 
the current position. 


2.2.4 The Current Position 


All GIDIS drawing instructions begin at the current position and 
end by setting a new current position. When you do not want the 
next drawing instruction to start where the last drawing 
instruction finished, use SET POSITION or SET_REL_ POSITION to 
move the current position to any point within GIDIS Output Space. 


2.2.5 Drawing Lines, Arcs, Filled Figures, Characters, Images 


You can draw one or ae series of lines. DRAW LINES and 
DRAW_REL_ LINES draw from the current position to the specified 
position. When you use either instruction in a series, each 


endpoint becomes the current position for the next line. 


You can draw arcs in much the same way with DRAW_ARCS or 
DRAW_REL_ARCS. All drawing begins at the current position and 
continues around a center point that you specify. As with 
drawing lines, you can draw arcs in a series, with each endpoint 
becoming the current position for the next arc. You determine 
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the direction and length of the arc by the angle. See Chapter 6 
for details. 


To draw a filled figure, you issue a BEGIN_FILLED_FIGURE 
instruction. You then use the instructions for drawing lines and 
arcs to designate the vertices of the figure. GIDIS stores’ the 
coordinate pairs for the vertices in the filled figure table. 
The order of the coordinates determines how the drawing proceeds. 
When GIDIS receives an END FILLED FIGURE instruction, it draws 
the filled figure. See Chapter 6 for limitations on the filled 
figure table. 


To draw characters you must first have selected the current 


alphabet with a SET_ALPHABET instruction. Section 2a2.421 
describes how to do this. Once you have a current alphabet, you 
indicate which character you want to draw by an index. GIDIS has 
two instructions’ for drawing Characcers.. You can use 


DRAW_CHARACTERS for any alphabet, whether a standard one or one 
you design. You can use DRAW_PACKED_CHARACTERS for ASCII strings 
or any alphabet with fewer than 256 characters. With either 
instruction you can draw several characters in succession. The 
rendition of the characters is governed by the Text Attributes, 
described in Section 2.2.10. 


Table 2-3 summarizes the GIDIS Drawing Instructions. 


Table 2-3: Drawing Instructions 


Instruction Action 


SET _POSITION Moves the current position to an 
absolute point you specify. 


SET REL POSITION Moves the current position to a 
point you specify relative to the 
current position. 


DRAW_LINES Draws a line from the current 
position to an absolute point you 
specify. 

DRAW _REL LINES Draws a line from the current 


posivi1en toe da, point you Specify 
relative to the current position. 
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Instruction Action 


DRAW_ARCS Draws an arc from the current 
position around an absolute 
center point you specify. 


DRAW_REL ARCS Draws an arc from the current 
position around a center point 
you specify relative to the 
Current. position. 


BEGIN_FILLED_FIGURE Begins definition of a filled 

figure. 

END _FILLED_FIGURE Completes definition of a filled 
figure and draws the figure. 

DRAW_CHARACTERS Draws the character you specify. 

DRAW_PACKED CHARACTERS Draws two characters you specify 


in one word. 


2.2.6 Drawing Attributes 


Several classes of attributes affect how your drawing looks. 
Some, namely the Writing Attributes, affect everything you draw. 
(The GIDIS Writing Attributes can be called global attributes.) 
Others, for example Line, Filled Figure, and Text Attributes, 
affect only certain drawing instructions. See Table 2-4 for a 
Summary of the Drawing Attributes instructions. 


When you power-up GIDIS, there are default values for GIDIS 


attributes. These default values make it possible to use the 
virtual device immediately. Table 6-4 lists the default values 
For GIDIsS. -attributes.. You can restore these default values at 


any time by uSing an INITIALIZE instruction. 


However, you can specify your own values for these attributes by 
using the instructions explained in the following sections. 


2.2. Writing Attributes 
A drawing instruction operates on a pattern of ON and OFF bits (1 


and 0Q respectively). When you draw a line or arc, GIDIS derives 
the pattern from the line texture you specify. When you fill a 
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figure, GIDIS derives the pattern from the area texture you 
specify. When you draw a character, GIDIS derives the pattern 
from the raster image of the character. For example, the 


character "L" would be a horizontal and vertical line of 1’s ona 
field of Os. 


0000000000 
0100000000 
0100000000 
0100000000 
0100000000 
0100000000 
0100000000 
OD 701 TIO 0 
0000000000 


When you specify a pattern, you also specify its size in GOS 
MLS The size controls how many times each bit in the pattern 
is repeated. For example, each 0 and 1 in the sample "L" may be 
repeated several times, depending on the size specified. When 
the pattern is displayed on a view surface, each bit in the 
pattern may be applied to multiple hardware pixels. 


The writing attributes control how each drawing instruction 
interprets the pattern. There are four writing attributes: 
writing mode, primary color, secondary color, and piane mask. 


Writing mode controls the Boolean operation performed on each bit 
of the pattern. For example, the default writing mode, overlay, 
works as follows. For each 1 in the pattern, GIDIS sets’ the 
current pixel to the primary color. For each 0 in the pattern, 
GIDIS leaves the current pixel unchanged. Your choice of writing 
mode affects how the image displays. See SET_WRITING_MODE in 
Chapter 6 for a full description of the writing modes provided by 
GIDIS. 


SET _PRIMARY_COLOR specifies the color map index to use for all 
L's inthe bit pattern: 


SET_SECONDARY_COLOR specifies the color map index to use for all 
O'S i “Une Die. patcvern. 


SET PLANE MASK determines which planes are enabled for writing. 
Usually, you enable writing to all planes. This instruction ANDs 
(Boolean) the current color index and the plane mask (a 
representation of the planes you select). For the effect of a 
plane mask that is not set to all planes, see SET_PLANE_MASK in 
Chapter 6. 
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2.2.8 Line and Curve Attributes 
You can choose to draw lines and curves with a solid or patterned 
line. With SET_LINE_TEXTURE you select the bit pattern that 


determines the appearance of the lines you draw. 


You can also select the thickness of your drawing line with 


SET PIXEL SIZE. SET_PIXEL SIZE sets the size of the logical 
pixel used as a paintbrush in subsequent drawing. The pixel is 
always a rectangle orthagonal to the x and y axes. Because of 


this, diagonal lines appear thicker than horizontal and vertical 
lines, except on a stroke device. 


Figure 2-3 shows different pixel sizes used to draw a line. 


Figure 2-3: Various Logical Pixel Sizes 


2.2.9 Filled Figure Attributes 


GIDIS allows you to select the two-dimensional pattern to be used 
in filling polygons. The pattern you choose is called the area 
texture cell. With the SET AREA TEXTURE instruction, you can 
choose either a character from an alphabet, or the current line 
texture as your area texture cell. Whatever pattern you choose 
remains the current area texture cell until you change it with 
another SET AREA TEXTURE. 


You can choose a character from any alphabet, for example the 
default DEC Multinational Character Set, or an alphabet you 
create. Note, there is a 16 by 16 bit size restriction for a 
Character used as a texture cell. However, with 
SET_AREA_TEXTURE_SIZE, you can enlarge the character used in 
Filling a figure. GIDIS does this by multiplying the pattern in 
the texture cell. You can also clip unwanted white space from a 
text cell with SET AREA CELL SIZE. 
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If you want a solid fill, specify a solid line with 
SET_LINE_ TEXTURE and choose the current line texture as your area 
texture cell. 


2.2.10 Text Attributes 


With GIDIS Text Attribute instructions you control the _ size, 
Spacing, orientation, and rendition (such as bold or italics) of 
text. 


The GIDIS text model is based on the notion of character cell. A 
Character cell is a rectangular field of ON and OFF bits. ON 
bits form a character pattern; OFF bits form the background. The 
Character cell that stores the bit patterns can be up to 64 bits 
high and 64 bits wide. 


You determine how the character cell is displayed by specifying 
the unit cell size and display cell size. SET_CELL_UNIT_SIZE 
specifies the size of the character you want displayed. GIDIS 
can scale the stored character cell to create larger or smaller 
characters. Scaling up 1s restricted to multiples of the bit 
pattern in the character cell. 


SET_CELL_DISPLAY_SIZE gives you a way of extending the background 
field if you want. Having a display cell larger than the unit 
cell is an easy way to create white space between characters. 
You must always set both unit and display cell size, even if they 
are identical. 


Besides setting a display cell width larger than a unit cell 
width to create white space, you can control spacing between 
character cells by specifying how to update the current position 
after a character is displayed. You have three choices: 


® Implicit movement only. Specify implicit movement with 
SET CELL _MOVEMENT_MODE and set explicit movement to (0,0) 
with SET_CELL_ EXPLICIT MOVEMENT. This causes the current 
position to move a display cell width along the current angle 
of cell rotation. If the current angle is 0, normal left to 
right text results. 


e Explicit movement only. Specify no implicit movement with 
SET_CELL_MOVEMENT_MODE and set explicit movement to whatever 
you want with SET_CELL_EXPLICIT_MOVEMENT. For example, if 
you want upright characters drawn diagonally up to the right, 
set explicit movement to (n,-n). Note, however, that unless 
your explicit movement is greater than the display cell size, 
your characters overwrite each other. 
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@® Implicit and explicit movement. Specify implicit movement 
with SET_CELL_MOVEMENT_MODE and explicit movement with 
SET_CELL_ EXPLICIT MOVEMENT. If you use both implicit and 
explicit movement, your characters move a display cell width 
plus whatever explicit movement you specify. 


Figure 2-4 shows the three possibilities. 


ABC 


Implicit Movement Only 


ABC 


Explicit Movement Only 


A B C 


Implicit and Explicit Movement 


Figure 2-4: Implicit and Explicit Movement 
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GIDIS allows you to control how accurately the current position 
is updated. For device-independence and complete accuracy at the 
level of GOS, specify global symmetry. For best performance = and 
constant intercharacter spacing, specify local symmetry. You 
specify symmetry with SET_CELL_MOVEMENT_MODE. 


Accuracy and constant spacing are contradictory goals, because 
unit cell width may not be an integral number of hardware pixels. 
For example, suppose you specified a spacing of 25 GOS units, and 
the current output device had one hardware pixel for every two 
GOS units. With local symmetry, each character would move 24 GOS 
units. With global symmetry, each move would be 25 GOS units 
conceptually, but actually 12 pixels, then 13, 12, 13 and so on. 


A character’s orientation (the direction the character faces) 
depends on the angle of rotation as specified by 
SET_CELL_ROTATION. A character’s angle of rotation is with 
respect to its top left corner. A positive angle rotates the 
left edge of the cell counter-clockwise; a negative angle rotates 
the left edge of the cell clockwise. The entire character cell 
rotates, without changing the shape of the cell. Figure 2-5 
shows character cell rotation. 


Figure 2-5: Character Cell Rotation 
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You can change the shape of the cell by using SET_CELL_OBLIQUE. 
When you specify a nonzero angle, the character cell becomes a 
parallelogram. A positive angle results in ae back-slanted 
character; a negative angle ina front-slanted character. 


You select various cell renditions by setting the appropriate 
flag with the SET_CELL_RENDITION instruction. If possible, GIDIS 


selects a font with the specified rendition. Otherwise, GIDIS 
algorithmically creates the specified rendition. You can specify 
the following rendition attributes: back-slant, italics, bold 


and proportional text. 


Table 2-4 summarizes the GIDIS Drawing Attributes. 


Table 2-4: GIDIS Drawing Attributes 


Instruction Action 


Writing Attributes 


SET_PRIMARY_COLOR Identifies the color map entry 
to use when drawing subsequent 
ON bits. 

SET_SECONDARY_COLOR Identifies the color map entry 
to use when drawing subsequent 
OFF bits. 

SET _PLANE_MASK Specifies which planes are 
accessible. 

SET_WRITING_MODE Selects writing mode to use in 


subsequent drawing. 


Line and Curve Attributes 


SET_LINE_TEXTURE Specifies the pattern used in 
drawing lines. 


SET_PIXEL_SIZE Specifies the thickness of the 
drawing line. 
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Instruction 

Filled Figure Attributes 
SET_AREA_TEXTURE 

SET _AREA TEXTURE SIZE 


SET AREA CELL SIZE 


Text Attributes 


SET_CELL_UNIT_SIZE 


SET CELL DISPLAY SIZE 


SET CELL EXPLICIT MOVEMENT 


SET CELL MOVEMENT _MODE 


SET CELL_OBLIQUE 


SET_CELL_ ROTATION 


' SET CELL RENDITION 


a 


Action 


Selects the character to use as 
the texture cell in filling 
subsequent figures. 


Specifies the size to draw 
subsequent texture cells. 


Clips or pads the last selected 
texture cell. 


Specifies the size to draw 
subsequent character cells. 


Specifies the size of a 
character’s background field. 


Specifies the distance to move 
the current position after a 
character is drawn. 


Specifies how the current 
position moves after a 
character is drawn, and how 
accurately the current position 
is updated. 


Specifies how much to slant the 
character display cell. 


Defines the angle of rotation 
at which subsequent characters 
are drawn. 


Selects character renditions 
such as backslant, italics, 
bold, and proportional spacing. 
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2.2.11 Alphabets and Fonts 


GIDIS uses the current alphabet in all text operations. TO 
select an alphabet, use SET_ALPHABET. The selected alphabet 
remains current until you do another SET _ALPHABET. 


A GIDIS alphabet is like an ASCII character set. When you 
specify an index within an alphabet, you know which particular 
character should be displayed. For example, the default alphabet 
(alphabet 0) is the DEC Multinational Character Set. When you 
specify index 101 (octal), you know that an uppercase "A" will be 
displayed. 


A Tonty on: the other hand, controls what. the "A" looks Like. A 
font’s general appearance is denoted by typeface, for example 
Courier. A font has a rendition, for example roman, italic, 
bold, or bold italic. Fonts may be monospaced (each character 


cell has the same width) or proportionally spaced (character cell 
width varies with the character, for example the cell containing 
the character "m" is wider that the cell containing the character 
ial a et 


You create more than one font for an alphabet for improved 
quality. As Section 2.5 explained, GIDIS enables you to vary the 
appearance of text in a number of ways. GIDIS achieves these 
variations by either selecting a new font or algorithmically 
transforming the current font. Because there are limits to what 
can be effectively done by algorithmic transformation, you can 
ensure better quality by supplying a variety of fonts. 


With GIDIS, you are not limited to standard alphabets) and 
character sets. You can build your own alphabets and design your 
own glyphs, the graphic representations of each member of the 
alphabet. S@CtION 222,13 explains ‘Now oO -a0. Dota. You may mave 
up to 16 alphabets available at any time and an unlimited number 
or fonts. When you first select an alphabet from 1-15, it 
contains no characters. You fill the alphabet in one of two 
ways: you load a font file with LOAD_BY_NAME, or you dynamically 
create a font with CREATE ALPHABET. 


2.2.12 Font Files 


A font file is simply a font that has been stored in a file. 
Appendix D explains how to name and store a font file so that the 
font server can use it. 


INTRODUCTION TO GIDIS INSTRUCTIONS 


You load a font file with the LOAD _BY_NAME Instruction. 
LOAD_BY_NAME has two formats. Format 1 selects a specific font 
file. This format is primarily provided for compatibility with 
earlier versions of GIDIS. (See Chapter 6 for details.) 


Format 2 (also called a family LOAD_BY_NAME) selects a typeface, 
known in GIDIS as a font family and identified by a family ID. 
When you do a Family LOAD_BY_NAME, you have really selected a 
pool of fonts. As you vary text attributes (such as unit cell 


Size) and rendition attributes (such as bold), GIDIS 
automatically switches to the font file of the current family 
that best satisfies the attributes you have _ selected. (See 


Chapter 6 for details.) 


2.2.13 Dynamically Created Fonts 


You can build a font with CREATE ALPHABET. This instruction 
establishes a storage cell size for each glyph in the font and 
the number of glyphs it contains. When you build a font with 
CREATE_ALPHABET you have two options for designing each glyph. 
With LOAD_CHARACTER_CELL you define a glyph by rows of bit 
patterns within a character cell. This method of defining glyphs 
is well-suited to raster devices. 


With BEGIN_DEFINE_CHARACTER and END_DEFINE_CHARACTER, you create 
a glyph by drawing into the character cell with any of the GIDIS 
drawing instructions. All instructions between 
BEGIN_DEFINE_CHARACTER and END_DEFINE_CHARACTER draw into the 
character cell. This method of defining glyphs is well-suited to 
any device. 


A font created dynamically with CREATE_ALPHABET has certain 
disadvantages. 


® It takes time to build the font each time your application 
runs. 


e The font remains defined only until you put another font into 
its alphabet. | 


® The font is stored in Read/Write memory. As a result, it 1s 
expensive to swap it to disk. 


Thus, CREATE ALPHABET should be used primarily for small, special 
alphabets like a set of patterns for filling figures. 
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If you are using P/OS, you can store a dynamically created font 
in a font file, by using the GIFONT routine of the GIDIS Call 
Interface. See Chapter 4 and Appendix D for details. 


Table 2-5 summarizes GIDIS instructions for alphabets and fonts. 


Table 2-5: Alphabet and Font Instructions 


Instruction Action 
SET ALPHABET Selects the current alphabet. 
LOAD _ BY _NAME(1) Loads the specified font file 


into the current alphabet. 


LOAD _BY_NAME(2) Associates the current alphabet 
with the specified font family. 


CREATE_ALPHABET Reserves storage space for a new 
alphabet font. Specifies the 
number of glyphs in the alphabet 
and the size of glyphs in the 
bon Gs 


LOAD_CHARACTER_CELL Defines a glyph in terms of bit 
patterns within a character cell. 


BEGIN DEFINE CHARACTER Starts a character definition 
block. All subsequent 
instructions draw into the 
character cell. 


END DEFINE CHARACTER Completes a character definition 
block and draws the glyph. 


INTRODUCTION TO GIDIS INSTRUCTIONS 


2.2.14 Reports 


You can ask GIDIS to generate various reports. You do this by 
issuing the appropriate request instruction. You read the report 
uSing GIREAD, as described in Chapter 4 (for P/OS) or Chapter 5 
(for RT-11). 


You can use reports to control program flow. For example, the 
position after a DRAW_ARCS or DRAW_CHARACTERS (local symmetry) 
may be different than what your program computes. You can check 


the actual current position with REQUEST _CURRENT_POSITION. 


You can also use reports during debugging. In particular, every 
GIDIS instruction sets current status to SUCCESS or FAILURE. You 
may want to check current status after each GIDIS instruction 
when debugging. However, the cost of REQUEST_STATUS is too high 
for such use in a running application. 


Table 2-6 summarizes a ll the GIDIS report generating 
instructions. 


Table 2-6: Report Instructions 


Instruction Action 


REQUEST CELL STANDARD Reports in current GOS units the 
cell width and height to specify 
to generate standard size 
characters. 


REQUEST_CURRENT_POSITION Reports the current position. 


REQUEST OUTPUT SIZE Reports the attributes of the 
current device’s view surface. 


REQUEST_STATUS Reports the success or failure of 
the last instruction. 


REQUEST_VERSION_NUMBER Reports characteristics of the 
current drivers 


CHAPTER 3 
PRO/GIDIS INSTRUCTION SYNTAX 


The PRO/GIDIS interpreter accepts a stream of PRO/GIDIS 
instructions. An instruction consists of an operation code 
(opcode) word, and some number of argument words. 

The format of an opcode word is: 


high byte low byte 


Most GIDIS instructions require a fixed number of arguments. For 
example, SET_POSITION needs exactly two arguments. 


some GIDIS instructions accept a variable number of arguments, 
depending on whether optional arguments are included. 
Instructions in this category include: LOAD_BY_NAME and 
CREATE ALPHABET. When an optional argument is omitted, GIDIS 
supplies a default as described in Chapter 6. 


Some fixed length instructions are repeatable. You can repeat 
some of the arguments without repeating the opcode. For example, 
DRAW.REL LINES B21, Yl, -X2, Y2, X3, ¥3 as equivalent we) 
DRAW_REL_ LINES X11, Yl DRAW _REL LINES X2, Y2, DRAW_REL_LINES X3, 
Yo%4 The instructions in this class include: DRAW_LINES, 
DRAW_REL_LINES, DRAW_ARCS, DRAW_REL_ARCS, DRAW_CHARACTERS, and 
DRAW_PACKED CHARACTERS. 


3.1 OPCODE BYTE 


Each GIDIS instruction has a corresponding numeric code. For 
example, the INITIALIZE instruction has an opcode of 1, while the 
SET_PRIMARY_COLOR instruction opcode is 21. (Appendix A provides 


a List of PRO/GIDIS instructions and their corresponding 
opcodes.) 


OPCODE: ‘BYTE 


Your program can define PRO/GIDIS instruction names as numeric 
constants. For example, in MACRO-11, this could be: 


des 
Plea 


GSINIT®T 
GSPRIM 


In FORTRAN, this could be: 


INTEGER*2 GINIT,GPRIM 
PARAMETER (GINIT = 1, GPRIM = 21) 


In PASCAL, this could be: 


CONST 
INITIALIZE = 1; 
SET PRIMARY COLOR = 21; 


3.2 LENGTH BYTE AND THE ARGUMENT LIST 


The length byte dictates the format of the instruction’s argument 
Pst: counted or uncounted. Generally, you use a counted list 
for instructions with a fixed number of arguments, and an 
uncounted list for instructions with a variable number of 
arguments. However, you can use either a counted or uncounted 
argument list with any instruction. 


A length value in the range 0 to 254 indicates a counted argument 
list. For example, if you specify a length value of two, 
PRO/GIDIS expects two argument words as shown below: 


toe Te Ze,29% FINStErUCclion: data: block.léengun. = 2 
;Opcode for SET_POSITION instruction = 29 

- WORD 100% 7x coordinate for current position 

. WORD 3:5. Us -y coordinate for current positron 


;Following execution of this instruction, 
;the current position is 100,350. 


A length value of 255 indicates an uncounted argument list. 
Uncounted argument lists are terminated by an END_LIST 
instruction word (-32768), as shown below. Thus an argument word 
in an uncounted argument list cannot contain the value -32768. 


2BYTE 2095e,20.7 introduces an uncounted. argument 136t 
;opcode for DRAW_REL LINES 

. WORD ol Oe oe al 

. WORD = 30%: fay 1 

.WORD 20.2 a0 boy 

.WORD +60. ak ae: 

.WORD #32160. {END GEST instruction. opcode: word 


322 


SYNTAX ERRORS 


3.3 SYNTAX ERRORS 


If GIDIS does not recognize an instruction opcode, it ignores 
that instruction and accompanying arguments. It also sets the 
status flag to FAILURE. If GIDIS encounters an instruction with 
insufficient arguments, it does not execute the instruction and 
sets the status flag to FAILURE. If GIDIS encounters an 
instruction with extra arguments, it executes the instruction as 
though the extra arguments did not exist. 


For example, a SET_POSITION instruction with only one argument is 
ignored, while a SET_POSITION with three arguments is executed 
using only the first two arguments. 


There are only two ways to confuse the GIDIS interpreter: 


@ Use END_LIST as an argument word in an uncounted argument 
LEets 


® Specify an argument count that differs from the actual number 
of arguments passed. 


If you do either, you must reinitialize GIDIS. See the 
INITIALIZE instruction in Chapter 6. 


CHAPTER 4 
USING PRO/GIDIS WITH P/OS 


This chapter describes how to use the GIDIS Call Interface 
(GIDCAL) with P/OS. It assumes you understand the conceptual 
framework of PRO/GIDIS (described in Chapter 2) and the PRO/GIDIS 
instruction syntax (described in Chapter 3). 

@ Section 3.1 describes the GIDIS Call Interface (GIDCAL). 

@® Section 3.2 describes the various devices accessed by GIDCAL. 
@® Section 3.3 explains how to build a task with GIDCAL. 


@e Section 3.4 documents GIDCAL error reporting. 


@e Section 3.5 lists sample programs for P/OS. 


4.1 THE GIDIS CALL INTERFACE (GIDCAL) 


The GIDIS call interface (GIDCAL) allows you to access each of 
the various GIDIS devices in the same way. GIDCAL consists of 
Six routines: 


@ GIOPEN 
@® GIWRIT 
@® GIREAD 
@ GICLOS 
@® GIFONT 
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@e GIPLAY 


You access each routine by using the FORTRAN-compatible calling 
sequence (sometimes called the R5 calling convention). This 
means arguments are passed by reference, R5 is set to point to 
the argument list, and Ri through R5 are preserved by the called 
routine. 


These standard routines make it easy for you _ to develop 
applications in high-level languages. You can use GIDCAL from 
MACRO-11 or any Tool Kit high-level language that supports 
FORTRAN-style calls. 

Normally you use GIDCAL as follows: 

1. Select the GIDIS driver you want to use with GIOPEN. 


2. Pass GIDIS instructions with one or more calls to GIWRIT. 


3. Read reports from REQUEST-type instructions, if any, with 
GIREAD. 


4, Terminate the GIDIS connection with GICLOS. 


Each GIDCAL routine returns a status code that indicates the 


results of the requested operation. If the operation is 
successful, a code of 1 is returned. If the operation is 
unsuccessful, a two-word error code block is returned. Section 


4.4 explains how to interpret the codes. 


You may have more than one GIDIS connection open at a time. This 
is useful if you want to print a GIDIS graphic while maintaining 
a connection to video GIDIS. GIDIS knows which driver to_ send 
instructions to by the Logical Unit Number (LUN) you specify with 
the GIOPEN call. 


NOTE 
Some high-level languages may reserve certain 
LUNs for their own use. If this is the case, you 
Cannot access the same LUN. Check language 


documentation prior to assigning LUNs. 


The following sections describe each GIDCAL routine and its 
arguments. The actual syntax for passing these arguments is 
specific to the high-level language you are using. See language 
documentation for details. 


THE GIDIS CALL INTERFACE (GIDCAL) 


4.1.1 GIOPEN 


GIOPEN initiates contact with the GIDIS driver of your’ choice. 
You choose a driver by specifying device type (Devtype) in the 


list of arguments. If you try to GIOPEN an active driver, Status 
1s set to (-1,-7). 


A GIOPEN does not affect the state of GIDIS. All attributes 
currently selected remain in force. 


The list of arguments for GIOPEN follows. 
GIOPEN (Status, LUN, Message, Msglen, Devtype, Driver) 


Status A two-word integer array used to return a code 
indicating the results of the requested 
operation. 


LUN Unit-number associated with this GIOPEN. It 
Should be an integer from 0 to 15. If not, 
Status is set to (-5,-1). If this LUN is 
already assigned to a GIDIS driver, Status is 
set to (-5,-4). 


Message Data to send to the driver when contact is 
initiated. Except as noted in Section 4.2, 
Message should be a word containing a 0. 


Msglen The number of words in Message. Except where 
noted, it should be 1. If Msglen is less than 0 
or greater than 128, Status 1s set to (=-3;,-3). 


Devtype An integer that identifies the desired output 
device. If Devtype is invalid, Status is set to 
(-5,-2). If you try to GIOPEN a device for 
which there is no driver, Status 1s set to 
(-1,-2). The device types are: 


- Disk File 

- LA50 

- LQOPO2 | 

- LA100/LA210 
- LVP16 

Other 

- Video 

- LNOQ3 

- Palette 

- LOPO3 


OoMmMrAIHNDNUN SPWN Fr CO 
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Driver Normally a 0. It should be nonzero only if you 
need to override the driver designated for the 
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device. (See Section 4.2 for driver names.) If 
you supply your own driver, identify it by the 
task name, in Radix-50. 


Normally, the argument list for GIOPEN is (Status, LUN, 0, 14, 
Devtype, Q). 


4.1.2 GIWRIT 


GIWRIT outputs a buffer of GIDIS command data to the specified 
GIDIS driver. The data ina buffer does not have to start or end 
on a command boundary. 


The list of arguments for GIWRIT follows. 
GIWRIT (Status, LUN, Message, Msglen) 

Status A two-word integer array used to return a code 
indicating the results of the requested 
operation. 

LUN Identifies the GIDIS driver to talk to. If no 
GIOPEN has been done for the specified value, 
Status is set to (-5,-1). 


Message The command data to send to the specified 


Graver: 

Msglen The number of words in Message. If it is less 
than 0 or greater than 4095, Status is set to 
CSO yee 


4.1.3 GIREAD 


GIREAD waits for GIDIS to return the report and places it in the 


specified buffer. If the report is longer than the specified 
buffer, the end of the report is truncated. If the report is 
shorter than the specified buffer, the trailing words of the 


buffer are left unchanged. 
The list of arguments for GIREAD follows. 
GIREAD (Status, LUN, Buffer, Buflen) 
Status A two-word integer array used to return a code 


indicating the results of the requested 
operation. 
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LUN Identifies the GIDIS driver sending the report. 
If no GIOPEN has been done for the specified 
device driver, Status is set to (-5,-1). 

Buffer Room for the report returned by GIDIS. Recall 


that the first word of a report contains a 
header specifying the type of report and the 
number of words in the buffer. 


Buflen The number of words in the report buffer. 
4.1.4 GICLOS 
GICLOS tells the specified GIDIS to end the connection. GICLOS 


does not return to its caller until the specified GIDIS has told 
it that all picture data has been output to the device. 


A GIDIS driver processes a GICLOS by simulating an END_PICTURE 
instruce1 on. (See Chapter 6 for details.) If the driver is not 
Video GIDIS, it exits when it has finished processing the 
PLeCCUre. 


If the driver is the type that buffers a picture before writing 
it, (for example, GSBITM) GICLOS causes picture output to 
commence if either: 


e® The user task has not done any END_PICTURE commands. 


e The user task has done drawing commands since its last 
END PICTURE. 


The list of arguments for GICLOS follows. 
GICLOS (Status, LUN) 
Status A two-word integer array used to return a code 


indicating the results of the requested 
operation. 


LUN Tdentifies the GIDIS driver to terminate. If no 
GIOPEN has been done for the specified value, 
Status is set to (-5,-1). 
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4.1.5 GIFONT 


GIFONT is independent of the other routines in GIDCAL. You use 
it to create a font file from the font loaded into alphabet 15. 
See CREATE ALPHABET, SET ALPHABET, BEGIN_DEFINE CHARACTER, and 
LOAD _CHARACTER_CELL in Chapter 6 for information on how to create 
a GIDIS: font. 


The list of arguments for GIFONT follows. 
GIFONT (Status, File spec, Len, Region name, Buffer, APR, LUN) 


Status A two-word integer array used to return a code 
indicating the results of the requested 
operation. 


File spec Name of the font file you want created in ASCII. 
For example, "MYFONT.TSK." 


Len Number of characters in File spec. 


Region name Name (in Radix-50) to use for the font region 
when the font file is later used by GIDIS. See 
Appendixes C and D for details. 


Buffer 256 word buffer that GIFONT uses as a temporary 
work area. 


APR APR that GIFONT maps alphabet fifteen’s font 
into (8KB at a time). 


LUN Driver GIFONT should use when writing a font 
File spec 


If you want to create a stroke font file (as opposed to a raster 
font file), you must: run. Plotter GIDIS. This ensures: that the 
font is properly stored. To indicate a stroke font in the  .FDF 
file (see Appendix D), specify a cell width and height of 1. 


4.1.6 GIPLAY 


Like GIFONT, GIPLAY is independent from the other GIDCAL 
routines. GIPLAY plays back the specified .GID file to the 
current output device, such as the video monitor. The file you 
want to play back must be on the local node. Only one task at a 
time can be doing a playback. 
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(GIDCAL) 


To use GIPLAY, you must first install the following file: 


INSTALL 


[ZZSYS ]CGLGRT.TSK 


The list of arguments for GIPLAY follows: 


GIPLAY (Status, 


Status 


LUN 


File spec 


LUN, File Spec, Len) 


A two-word integer array used to return a 
results 


indicating the 


operation. 

Identifies the GIDIS 
If no GIOPEN has 
value, Status is set 


Name of the file you 


code 


of the requested 


driver writing the picture. 
been done for the specified 
CO. -(=5;,2L)% 


want played back. 


Len Number of characters in File spec. A File spec 
can contain 1 to 59 characters. A length 
outside these bounds returns a Status ope 
(-5,-5). 


4.2 DEVICES ACCESSED BY GIDCAL 


The Devtype value defined in a GIOPEN tells GIDIS which driver to 


access. Information about each device and its associated driver 
follows. 
4.2.1 Disk File 


The Message argument to GIOPEN should be the file specification 
that is the output device. There should be a null byte following 
the characters in the file spec. The Msglen argument to GIOPEN 
is the number of words in the file spec. Thus, whether the file 
specification is "A.GID" or "AB.GID", Msglen contains 3. 


Calling GICLOS closes the file. 


The driver is the task GSFILE. 
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4.2.2 LA50 

The device area is assumed to be 8 inches wide by 10 and 2/3 
inches high. The picture is automatically drawn to best fill the 
available area, so a landscape picture is drawn sideways. 


Picture drawing starts when an END_PICTURE instruction is issued 
(or GICLOS simulates one). 


The driver is the task GSBITM. 


4.2.3 LQP02 


No GIDIS driver is supplied for the LQP02. However, GIOPEN tries 
to access a task named GSLOP. If GSLQOP does not exist, GIOPEN 
fails with Status set to (-1,-2). 


4.2.4 LA100/LA210 


The device area is assumed to be 8 inches wide by 10 and 2/3 
inches high. The picture is automatically drawn to best fill the 
available area, so a landscape picture is drawn sideways. 


Picture drawing starts when an END_PICTURE instruction is issued 
(or GICLOS simulates one). 


The driver is the task GSBITM. 


4.2.5 LVP16, HP7475, HP7470 Plotters 


The user controls the device area by setting a dip switch. If 
set to A3, the area is about 17 inches wide by 11 inches high. 
If set to A4, the area is about 10 inches wide by 7.5 inches 
high. The picture is automatically drawn to best fill the 
available area, so a portrait picture is drawn sideways. 


NOTE 


The large paper size and portrait output do not 
apply to the HP7470. | 


The driver is the task GSHPGL. 
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4.2.6 Other Device 


This device type is for accessing a private GIDIS. This allows 
third-party suppliers to develop alternative GIDIS devices. The 
format and content of the initialization message depend on the 
device supplier. However, we do suggest that suppliers allow a 
one-word message containing a zero. 


No device driver is supplied for device type Other. However, 
GIOPEN tries to access a task named GSOTH. If the device 
Supplier gives his GIDIS driver a different name than GSOTH, he 
must specify that name in the Driver argument to GIOPEN. 
Remember, the driver name should be the task name in Radix-50. 


4.2.7 Professional Video 


The device area is the entire screen. The screen is 8 units wide 
by 5 units high. 


Picture drawing occurs as GIDIS instructions are received. 


The driver is part of the Terminal Subsystem. 


4.2.8 LNO3 


The device area is assumed to be 8 inches wide by 10 and 2/3 
inches high. The picture is automatically drawn to best fill the 
available area, so a landscape picture is drawn sideways. 


Picture drawing starts when an END_PICTURE instruction is issued 
(or GICLOS simulates one). 


The driver is the task GSBITM. 


4.2.9 Polaroid Palette 


The device area is the entire print or slide. It is nominally 4 
units wide by 3 units high. 


Picture drawing starts when an END_PICTURE instruction is issued 
(or when GICLOS simulates one). During picture drawing, the 
Palette driver uses the video screen aS a work area. When a 
slide camera is being used, GIOPEN opens the camera’s shutter; 
GICLOS closes it and advances the film. 
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The driver is the task GSPAL. If it sets Status to (-6, any), it 
means a Palette I/O error has occurred. The second word of 
Status is the code returned by the Palette system. Table 4-1 
lists the error codes, their meanings, and user actions. 


Table 4-1: GIDCAL Palette Errors 


Palette Decimal Error User Action 
Code Value 
Oe 48 invalid Palette Report to Polaroid 
command 1£ the error 
recurs. 
a 49 Invalid argument to Report to Polaroid 
Palette command if the error 
recurs. 
ee 50 Filter wheel error Report to Polaroid 
if the error 
recurs. 
ae 51 Communications Try readjusting 
error RS-232 cable. If 


the error recurs, 
report to Polaroid. 


"an 52 No vertical sync Try readjusting 
video cables and 
turning Palette off 
and on. If the 
error recurs, 
report to Polaroid. 


4.2.10 LQPO03 


No GIDIS driver is supplied for the LQP03. However, GIOPEN tries 
to access a task named GSLOP. If GSLOP does not exist, GIOPEN 
fails with Status set to (-1,-2). 
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4.3 BUILDING A TASK WITH GIDCAL 


GIDCAL is part of the PRO/Tool Kit. To link GIDCAL with your 
task, specify GIDCAL/LB just as you would for any other .OLB 
file. GIDCAL.OLB is on LB:[{1,5]. GIDCAL, without GIFONT, uses 
about 800 words of your address space. 


When you use GIFONT, you must include RMS in your task, plus room 
for the data area you pass to it. 


Note the driver-specific instructions in Sections 4.4.1 and 
4.4.2. 


4.3.1 Video GIDIS 


@ When accessing Video GIDIS, GIDCAL uses one event flag (EFN). 
The default EFN is 29. If you want to give the EFN a 
different value, specify GBLDEF=GISEFN:value in the task 
build command file. 


e GIOPEN assigns the LUN you specified, if Devtype is Video. 


4.3.2 Other GIDIS Drivers 


e The GIDIS tasks GSBITM, GSHPGL, and GSPAL were built with an 
assigned ASG of the form ASG=LP:1. When one of these tasks 
starts up, it attaches the device associated with LUN 1; 
consequently, you cannot attach this device. 


e Do not use the RSUMS and SPNDS system directives with GIDCAL. 


e GICLOS sends a one-word message that contains a -1. 
Therefore, you should not send such a buffer using GIWRIT. 


e If you plan to access an LA5O, LA100, or LNO3, put INSTALL 
[ZZSYS]GIBITM in your installation file. If you plan to 
access Palette, put INSTALL [ZZSYS]GIPAL in your installation 
file. If you plan to access a private GIDIS, add the 
appropriate INSTALL command to your installation file. 
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4.4 ERROR REPORTING 


All GIDCAL routines return a two-word status value. If the value 
of the first word is less than 0, an error was detected. The 
first word identifies the class of error; the second word 
identifies which error of the class has occurred. Table 4-2 
lists the error classes and user actions to deal with the 
problem. 


Table 4-2: GIDCAL Errors Listed by Class - P/OS 


Code Meaning User Action 


-1 Directive error Refer to RSX-11M/M-Plus 
Executive Reference 
Manual for specific 
error. 


-~2 L/O: BETOr Refer to IAS/RSX-11 
Operations Reference 
Manual for specific 
error. 


-3 RMS Error Refer to RMS-11 Macro 
Programmer’s Guide for 
specific error. 


-4 Internal error in GIDIS Report error to 
driver DIGITAL. 
-5 Interface error Refer to Table 4-3 for 


Specific errors. 


-6 Palette driver error Refer to Table 4-1 for 
Specific error. 


An error is driver-related if the first word of Status is 
anything but -5. This usually indicates a device problem (for 
example, the device is offline), but it could also mean that you 
passed a bad File spec to File GIDIS. Table 4-3 lists the types 
of errors for the value -5. 


Table 4-3: 


Code 


ERROR REPORTING 


GIDCAL Interface Errors - P/OS 


Error 


Invalid or unassigned 
LUN 


Invalid device type 


Improper message length 


LUN already attached to 
a GIDIS driver 


User Action 


Assign LUN with GIOPEN. 


See Section 4.3. 


Assign Msglen within 
range. 


Select a new LUN. 
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4.5 SAMPLE P/OS PROGRAMS 


4.5.1 


OBUF: 
RBUF: 


ERROR: 


OARG: 


WARG: 


.BLKW 2. 
SBYTE 02555; 
._BLKW 3. 

MOV #OARG, R5 
JSR PC,GIOPEN 
TST STAT 
BLE ERROR 
MOV #WARG, R5 
JSR PC,GIWRIT 
TST STAT 
BLE ERROR 
MOV #RARG, R5 
JSR PC, GIREAD 
TST STAT 
BLE ERROR 


MOV #CARG, RD5 
JSR PC, GICLOS 


ToL 
BLE 


-BYTE 
- WORD 
- WORD 
- WORD 
- WORD 
- WORD 
» WORD 


bx TE 
- WORD 
. WORD 
. WORD 
- WORD 


STAT 
ERROR 


operas, 
STAT 
LUN 
OPMSGL 
OPMLEN 
DEVTYP 
DRIVER 


4.,0. 
STAT 
LUN 
OBUF 
MSGLEN 


Sample MACRO-11 Program 


;Length=0 REQUEST _CURRENT_POSITION 


e 
? 


;BRANCH IF GIOPEN 


@ 
g 


>BRANCH IF GIWRIT 


SEND INSTRUCTION TO PRO/GIDIS 


FAILED 


SEND INSTRUCTION TO PRO/GIDIS 


FAILED 


;READ THE REPORT 


;READ THE REPORT 


*BRANCH IF GIREAD 


e 


e 
9 


FAILED 


RBUF: 
(LENGTH ) 


NEW CONTENTS OF 
BYTE AT RBUF 2. 
BYTE AT RBUF+1 1. 
(CURRENT POSITION REPORT HDR) 
RBUF+2: CURRENT X POSITION 
RBUF+4: CURRENT Y POSITION 


BRANCH IF GICLOS FAILED 


Error handling routine 
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RARG: 


CARG: 


STAT: 
LUN: 


OPMSGL: 
OPMLEN: 
DEVTYP: 
DRIVER: 
MSGLEN: 
BUFLEN: 


SAMPLE P/OS PROGRAMS 


-BYTE 4.,0. 
- WORD STAT 

- WORD LUN 
-WORD RBUF 

- WORD BUFLEN 


ae 2p a be <> Ze 
-WORD STAT 
-WORD LUN 


. WORD One 9-0" 
- WORD oe 
- WORD Dx 
- WORD O's 
- WORD 62. 
- WORD om 
- WORD 1% 
- WORD Cie 


4.5.2 Sample FORTRAN Program 


INTEGER*2 OBUF 
INTEGER*2 RBUF(3),STAT(2) 


OBUF 


55*256+0 !OPCODE 55=REQUEST_CURRENT_POSITION 
! LENGTH=0 


CALL GIWRIT (STAT, 5, OBUF, 1) 
IF (STAT.LE.0) GO TO 999 !'BRANCH IF GIWRIT FAILED 


CALL GIREAD (STAT, 5, RBUF, 3) 
IF (STAT.LE.0) GO TO 999 !'BRANCH IF GIREAD FAILED 


999 


NEW CONTENTS OF RBUF: 


' 
YoRBUF(1): 258 (i,e., 1*256+2 BECAUSE 

! 1 = THE REPORT HDR AND 2 = LENGTH OF DATA FOLLOWING) 
! RBUF(2): CURRENT X POSITION IN GIDIS OUTPUT SPACE 

! RBUF(3): CURRENT Y POSITION IN GIDIS OUTPUT SPACE 


! ERROR FOUND 


CHAPTER 5 
USING PRO/GIDIS WITH RT-11 


This chapter describes how to pass instructions to the GIDIS 
interpreter under RT-11. It assumes you understand the 
conceptual framework of PRO/GIDIS (described in Chapter 2) and 
the PRO/GIDIS instruction syntax (described in Chapter 3). 


RT-11 requires that the FPU (floating point unit) hardware be 
installed on the Professional running PRO/GIDIS. RT-11 v5.2 runs 
PRO/GIDIS only as the foreground job under the XM monitor. 
Information in Chapter 6 about other devices does not apply to 
PRO/GIDIS under RT-11. 


PRO/GIDIS requires two files: GIDIS.SAV and ALPHOO.FNT. 
GIDIS.SAV is the utility save image. ALPHOQ.FNT is the default 
GIDIS font file. Both files must be on the system (SY:) device. 


Issue the following command to start PRO/GIDIS and make it 
available to application programs: 


-FRUN GIDIS.SAV 


RT-11 provides software access to PRO/GIDIS using three 
interfaces. 


e The GIDCAL interface (GIDIS call routines) 

@e The MACRO-11 interface (.SPFUN programmed request) 

e® The FORTRAN interface (ISPFN/ISPFNC/ISPFNF/ISPFNW) 

The Professional Interface (PI) handler controls the operation of 
PRO/GIDIS and is transparent to the user. PRO/GIDIS instructions 


from application programs are sent to and received from PI using 
any of the above interfaces. 
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5.1 THE GIDIS CALL INTERFACE (GIDCAL) 


Under RT-11, the GIDCAL routines consist of four FORTRAN system 
subroutines: 


@ GIOPEN 
e GIWRIT 
@ GIREAD 
@ GICLOS 


The subroutines are located in the system subroutine library 
SYSLIB.OBJ. 


With the following exceptions, the GIDCAL routines work the same 
under RT-11 as they do under P/OS. 


@® GIFONT and GIPLAY, two GIDCAL routines available under P/OS, 
are not currently supported. 


@® For RT-11 V5.2, GIDCAL addresses only the PRO Video (Devtype 
6): 


e In GIWRIT the maximum message length (msglen) is 2048 decimal 
words. 


Normally you would use GIDCAL as follows: 
1. Initiate the GIDIS operation with GIOPEN. 
2. Pass GIDIS instructions with one or more calls to GIWRIT. 


3. Read reports from REQUEST-type instructions, if any, with 
GIREAD. 


4. Terminate the GIDIS connection with GICLOS. 


Each GIDCAL routine returns a status code that indicates’ the 


results of the requested operation. If the operation is 
successful, a code of 1 is-~ returned. If the operation is 
unsuccessful, a two-word error code block is returned. Section 


5.1.5 explains how to interpret the codes. 
NOTE 


Some high-level languages may reserve certain 
LUNs for their own use. If this is the case, you 
cannot access the same _ LUN. Check language 
documentation prior to assigning LUNs. 
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The following sections describe each GIDCAL routine and its 
arguments. The actual syntax for passing these arguments is 


specific to the high-level language you are using. See language 
documentation for details. 


5.1.1 GIOPEN 


GIOPEN initiates contact with the Professional interface (PI) 
handler and assigns a logical unit number (LUN) for this GIDIS 
operation. A GIOPEN does not affect the state of GIDIS. All 
attributes currently selected remain in force. 


To initialize the Professional video screen, execute the 
INITIALIZE -1 (complete initialization) instruction, followed by 
the NEW_PICTURE instruction. 


The list of arguments for GIOPEN follows. 
GIOPEN (Status, LUN, Message, Msglen, Devtype, Driver) 


Status A two-word integer array used to return a code 
indicating the results of the requested 
Operation. 


LUN Unit-number associated with this GIOPEN. It 
should be an integer from 0 to 15. If not, 
Status is set to (-5,-1). If this LUN is 
already connected to a GIDIS operation, Status 
is set to (-5,-4). 


Message Data to send to Video GIDIS. Message should be 
a word containing a 0. 


Msglen The number of words in Message. Except where 
noted, it should be 1. If Msglen is less than 0 
or greater than 128, Status is set to (-5,-3). 


Devtype An integer that identifies the desired output 
device. For RT-11 V5.2 only Devtype 6 is valid. 
Integer values 0 through 5, 7 and 8 are 
reserved. If Devtype is invalid, Status is set 
to (-5,-2). 


Driver 0, as RT-11 accesses only video GIDIS 


Normally, the argument list for GIOPEN is (Status, LUN, Oe. “aby 
Devtype, 0). 
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5.1.2 GIWRIT 

GIWRIT outputs a buffer of GIDIS command data to the specified 
GIDIS driver. The data in a buffer does not have to start or end 
on a command boundary. The list of arguments for GIWRIT follows. 


GIWRIT (Status, LUN, Message, Msglen) 


Status A two-word integer array used to return a code 
indicating the results of the requested 
operation. 

LUN Identifies the unit number assigned by GIOPEN. 
If no GIOPEN has been done for the specified 
value, Status is set to (-5,-1). 

Message The command data to send to Video GIDIS 

Msglen The number of words in Message. If it is less 


than 0 or greater than 2048 (decimal words), 
Status is set to (-5,-3). 


5.1.3 GIREAD 


GIREAD waits for GIDIS to return the report and places it in the 
specified buffer. If the report is longer than the specified 
buffer, the end of the report is truncated. If the report is 
shorter than the specified buffer, the trailing words of the 
buffer are left unchanged. 


The list of arguments for GIREAD is as follows. 


GIREAD (Status, LUN, Buffer, Buflen) 


Status A two-word integer array used to return a code 
indicating the results of the requested 
operation. 

LUN The unit number assigned by GIOPEN. If no 
GIOPEN has been done for the specified device 
driver, Status is set to (-5,-1). 

Buffer Room for the report returned by GIDIS. Recall 


that the first word of a report contains a 
header specifying the type of report and the 
number of words in the buffer. 


Buflen The number of words in the report buffer. 
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5.1.4 GICLOS 


GICLOS ends the GIDIS connection to the Professional interface 
handler. The output device treats a GICLOS subroutine as an 
END_PICTURE instruction. Control is returned to the calling 
program once all data specified by the GIWRIT subroutine has been 
sent to the output device. (See Chapter 6 for details.) 


The list of arguments for GICLOS is as follows. 
GICLOS (Status, LUN) 
Status A two-word integer array used to return a code 


indicating the results of the requested 
Operation. | 


LUN The unit number to terminate. If no GIOPEN has 
been done for the specified value, Status is set 
to (-5,-1). 


5.1.5 GIDCAL Error Reporting 


GIDCAL subroutines can return the following error codes’ and 
subcodes in the two-word status array. The first word specifies 
the class of the error; the second word specifies the type of 
error within the class. 


GIDCA running under RT-11 returns three classes of errors listed 
in Table 5-1. 


Table 5-1: GIDCAL Errors Listed by Class - RT-11 


Code Meaning 
-1 Directive error 
-5 Interface error 
i] Operating System Error 
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The directive error code (-1) can return the following subcode: 

-1 No handler. The output device handler is not loaded. 
The interface error code (-5) returns the subcodes listed in 
Table 5-2. 


Table 5-2: GIDCAL Interface Errors - RT-11 


Code Error 
-1 Invalid or unassigned LUN 
-2 Invalid device type 
-3 Improper message length 
-4 LUN already attached to a GIDIS driver 


In addition to the directive and interface errors, RT-11 also 
reports operating system errors (-7). Table 5-3 describes the 
specific errors within this class. 


Table 5-3: RT-11 Operating System Errors 


Code Error 


Codes returned during a GIDIS operation 


-1 Required argument missing. A required 
argument in a GIDCAL subroutine is not 
specified. 


-2 Handler not found. The indicated file was not 
found on the device. 


-3 File not found. The indicated file was not 
found on the device. 


i EE 


326 
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Code 


-6 


Codes returned when 
-129 
-130 
-131 


-132 


#133 
-134 
=135 


-136 


=137/ 


-138 
-~139 
~140 
-141 
-142 
-143 
-144 


-145 


Error 


File open on nonsharable or 
non-file-structured device. 


An attempt was made to read or write past the 
end-of-file (EOF) mark. 


Hard error. The GIDIS operation experienced a 
hard error on the output device. 


the .SERR programmed request is in effect. 
Called USR from completion routine. 

No device handler; this operation needs one. 
Error doing directory I/O. 

-FETCH error. An I/O error occurred while the 
handler was being used, or an attempt was 
made to load the handler over USR or RMON. 
Error reading an overlay. 

No more room for files in the directory. 


Reserved. 


Invalid channel number; number is greater 
than actual number of channels that exist. 


Invalid EMT, and invalid function code has 
been decoded. 


Reserved. 

Reserved. 

Invalid directory. 
Unloaded XM handler. 
Reserved. 

Reserved. 

Reserved. 


Reserved. 
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Code Error 


-146 Reserved. 


5.1.6 Sample Program Using GIDIS Call Interface 


The following FORTRAN program fragment uses the GIDCAL 
subroutines to request the current cursor position. 


C 
C Declare storage. 
C 
INTEGER*2 BUFLEN , LUN , MSGLEN , OCLEN , OPCODE 
INTEGER*2 BUFFER( 3 ) , MESSAG( 1 ) , STATUS( 2 ) 
C 
C User program begins here... 
C 
c 
C Assign Logical Unit Number. 
C 
LUN = 5 
C 
C Assign opcode (REQUEST_CURRENT_POSITION) and opcode 
c length (0). 
c 
OPCODE = 55*256 
OCLEN = 0 
G 
C Insert opcode and opcode length into message buffer 
C (one word). 
c 
MESSAG( 1 ) = OPCODE + OCLEN 
MSGLEN = j 
C 
C Send the message to GIDIS 
C 
CALL GIWRIT( STATUS , LUN , MESSAG , MSGLEN ) 
C 
@ Check for errors, 
C 
IF ( STATUS( 1) .LE. 0 ) GOTO 999 
C 
c Assign buffer length for report. 
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BUFLEN = 3 

Get a report from GIDIS. 

CALL GIREAD( STATUS , LUN , BUFFER , BUFLEN ) 
Check for errors. 

IF ( STATUS( 1 ) .LE. 0 ) GOTO 999 


Contents of BUFFER after successful return: 


BUFFER( 1 ) = 258 ( (1%*256) + 2 ) 

1 = Report header, 

2 = Number of data elements in buffer 
BUPFER( «2c ) = Current “X” position: in .GIDIsS. output space 
BUFFER( 3 ) = Current "Y" position in GIDIS output space 


User program continues from here... 


Handle errors. 


End of GIDCAL example. 


END 
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5.2 THE MACRO-11 PRO/GIDIS INTERFACE 


With the MACRO-11 interface, PRO/GIDIS instructions from 
application programs are sent to and received from the 
Professional interface handler using the .SPFUN programmed 
request. The .SPFUN programmed request is located in the 
distributed RT-11 MACRO library SYSMAC.SML. 


RT-11 supports PRO/GIDIS from MACRO-11 or any supported 
high-level language that uses external MACRO-11 routines. The 
recommended method is to write callable MACRO-11 routines’ that 
issue the .SPFUN programmed request. For information on calling 
the .SPFUN programmed request from a supported high-level 
language, refer to the documentation for that language. 


When programming for GIDIS using the .SPFUN request of ISPFN 
subroutines, you should initialize GIDIS before sending it your 
GIDIS instructions. Perform the following operations each time 
you begin a new program: 


1. Establish a channel to PI with the .LOOKUP request. 


2. Issue an .SPFUN 371 request and specify -1 for the went 
argument. 


3. Issue an .SPFUN 371 with the INITIALIZE instruction. 
4. Issue the .SPFUN 371 that writes your data buffer to GIDIS. 
RT-11 requires PRO/GIDIS to be the highest priority job. 


The following is a simplified illustration of the RT-11 PRO/GIDIS 
data path: 


sSPFUN: 371 


APPLICATION PROFESSIONAL GIDIS 
PROGRAM INTERFACE Ui Ly 
HANDLER 


.-SPFUN 370 


VIDEO 
TERMINAL 
DISPLAY 


THE MACRO-11 PRO/GIDIS INTERFACE 


5.2.1. .SPFUN 371 


The .SPFUN 371 writes (sends) one or more PRO/GIDIS instructions 
and their associated parameter values to the Professional 
interface handler ina buffer. The buffer must begin at an even 
address. The Professional interface handler passes the buffer to 
the GIDIS utility for processing. You can pass a maximum of 2048 
(decimal) words to the PI handler in one .SPFUN 371 request. 


The following is the structure of the .SPFUN 371 programmed 
request when used with the Professional interface handler. 


Macro Call: -SPFUN area,chan,func,buf,wcnt,blk 


area Is the address of a six-word EMT argument block 

chan Is the channel number in the range 0 to 376 (octal) 

func is. 371 

buf Is the address of the buffer containing the input to 
the GIDIS utility. Buf must start on ae_eword 
boundary 

bent Is the number of bytes of information being sent 

blk Is zero 


The .SPFUN 371 request can return error codes; see the RT-11 
Programmer’s Reference Manual for complete information. 


Issuing a REQUEST_STATUS instruction returns a report on_ the 
success or failure of an instruction sent by .SPFUN 371. Check 
the carry bit on return from .SPFUN 371 to determine whether’ the 
instruction was successfully sent to PRO/GIDIS. 


5.2.2 .SPFUN 370 


The .SPFUN 370 reads (returns) a buffer of information generated 
from a PRO/GIDIS REQUEST-type instruction (sent using .SPFUN 
371) The buffer must begin at an even address. The 
Professional interface handler passes the buffer address to 
PRO/GIDIS, and PRO/GIDIS loads the information into the buffer. 


The following is the structure of the .SPFUN 370 programmed 
request when used with the Professional interface handler. 
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Macro Call: .SPFUN area,chan,func,buf,bcnt,blk 

area Is the address of a six-word EMT argument block 

chan Is the channel number in the range 0 to 376 (octal) 

func rs:370 

buf Is the address of the buffer containing the input to 
the GIDIS utility. Buf must start on a_eword 
boundary 

went Is the maximum number of words the GIDIS utility can 


place in the buffer 


blk Is zero 


The .SPFUN 370 request can return error codes; see the RT-11 
Programmer’s Reference Manual for complete information. 


5.2.3 SAMPLE MACRO-11 PROGRAM 
The following example returns the current position of the cursor. 


GSRCP=:55. ; Specify instruction 
GSINT= = <2. > codes 


. LOOKUP #IOAREA,#0,#PIBLK ; Open PI on channel 0 
BCS ERROR ° Check for success 


~-SPFUN #IOAREA,#0,#371,,#-1,+#0 
° Initialize GIDIS 
BCS ERROR > Check for success 


e 
e 


-SPFUN #IOAREA,#0,#371,#REQPOS,#3,#0 
« Send the instructions 
* to initialize GIDIS 
; internal symbols and 
* REQUEST CURRENT POSITION. 


BCS ERROR > Check for success 


-SPFUN #IOAREA,#0,#370,#REPBUF,+#3,#0 
> Read the current 
7 POSLULON. 

BCS ERROR ; Check for success 
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; -SPFUN 370 causes the following report to be 
; placed in REPBUF: 


> BYTE. 2 (number of data words following). 
- BOR. ahs (CURRENT_POSITION_REPORT 

: identifier). 

; WORD x (PRO/GIDIS coordinates 

; WORD y for current position). 


; The current position of the cursor will be in 
; the second and third words of REPBUF. 


IOAREA: .BLKW 6 ; .SPFUN EMT argument block 
PIBLK: .RAD50O /PI / ; File name in Radix-50 characters 

.WORD 00-520 : 
REOPOS: «BYTE 1,GSINT ; Length=1, opcode = INITIALIZE 

. WORD -1 ; Initialize operand 

. BYTE 0,GSRCP ; Length=0, 

; opcode = REQUEST_CURRENT_POSITION. 

REPBUF: .BLKB 6 ; Buffer for info returned from GIDIS. 
ERROR: ; Error handling routine. 


5.3 THE FORTRAN PRO/GIDIS INTERFACE 

FORTRAN provides its own system subroutines 
(ISPFN/ISPFNC/ISPFNF/ISPFNW) that are used in the same manner as 
the MACRO-11 .SPFUN programmed requests. These subroutines are 
described in Chapter 3 of the RT-11 Programmer’s Reference 
Manual. The four subroutines are located in the distributed 
RT-11 system subroutine library SYSLIB.OBJ. 

Follow the order of operations described in Section 5.2. 


A sample FORTRAN program using the ISPFNW system subroutine 
Follows. 


SAMPLE FORTRAN PROGRAM 


The following example returns the current position of the cursor. 


Sample FORTRAN program for PRO/GIDIS. 


Declare storage. 


p> Taek le es GP ae 


INTEGER*2 RDCPOS: ; ROCPOS 


2=12 


eae a @ MQaAQa 


MQaQAQ 
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INTEGER*2 BLOCK , CHAN , STATUS , WCNT 
INTEGER*2 FILSPC( 4 ) 

BYTE REPBUF( 6 ) , REQBUF( 2 ) 
DATA | FILSPC/ 3RPI,0,0,0/ 


Assign SPFUN function codes ( Read, Request 


wey et 
ae ae pe 8 


RDCPOS 
ROCPOS 


Initialize default values. 
BLOCK = 0 


Get an RT-11 channel. 


STATUS = LGETC() 
IF ( STATUS .EQ. -1 ) GOTO 900 
CHAN = STATUS 


Open the PI handler. 


STATUS = LOOKUP( CHAN , FILSPC ) 
IF ( STATUS .NE. 0 ) GOTO 910 


Send the instruction to request from PI the current 


position. 

CODE = ROQCPOS 
WCNT = 1 
STATUS = 


ISPFNW( CODE , CHAN , WCNT , REQBUF , BLOCK 


IF ( STATUS .NE. 0 ) GOTO 920 


Read the current position. 


CODE = RDCPOS 
WCNT = 3 
STATUS = 


ISPFNW( CODE , CHAN , WCNT , REPBUF , BLOCK 


IF ( STATUS .NE. 0 ) GOTO 930 


User program continues from here... 


Close the channel. 


) 


ys 


AaAQ 


QYVAQ 
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STATUS = 


Return the channel to RT-11. 


STATUS = IFREEC( CHAN 


LE ( STATUS .NE. 


Go to common exit. 
GOTO 1000 


Error messages begin. 


TYPE 1 

FORMAT ( 1X , ’No channels available.’ 

GOTO 1000 

TYPE 2 

FORMAT ( 1%.» “Lookup..error on Pi:..’") 

GOTO 1000 

TYPE 3 

FORMAT ( 1X , ‘'Error requesting current 
position.” 

GOTO 1000 

TYPE 4 

FORMAT ( 1X , ‘Error reading current 
position.’ 

GOTO 1000 

LLPe 5 

FORMAT ( 1X , 'FATAL - SYSTEM ERROR.’ 

GOTO 1000 

TYPE 6 , CHAN 

FORMAT C AX , “Channe: £ I2 4 


‘ is not currently allocated.’ 


Common Exit point. 


CALL EXIT 


End of sample FORTRAN program for PRO/GIDIS. 


END 


ICLOSE( CHAN ) 
IF ( STATUS .NE. 


) 


0 ) GOTO 940 


QO ) GOTO 950 


) 
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5.4 RESTRICTIONS 


Observe the following restrictions when running PRO/GIDIS' under 
RT-11: 


@® Run PRO/GIDIS only under the XM monitor. 


@® Run PRO/GIDIS only as the foreground job using the FRUN 
command. 


® The area operation instruction PRINT_SCREEN is not supported. 


@e VT102 emulation is not supported. 


CHAPTER 6 
PRO/GIDIS INSTRUCTIONS 


This chapter contains detailed reference information for all 


GIDIS instructions, which are listed in alphabetical order for 
convenience. 


The entry for each GIDIS instruction includes the following 
information: 


e A brief description of the instruction. 
@® Opcode - used by GIDIS to identify the instruction. 


e Length - specifies the number of arguments for the 


INnStPuUCT LON . 

® Format - lists and describes each argument. 

e Status - indicates conditions for success or failure of the 
instruction. 


e Notes - explain in detail how to use the instruction. 


@e Device Notes - describe behavior specific to particular GIDIS 
drivers. 


® Example - lists excerpts from a sample MACRO-11 program that 
uses the instruction. 


Unless specified otherwise, all units are in GIDIS Output Space 
(GOS). 


BEGIN_DEFINE CHARACTER 


6.1 BEGIN DEFINE CHARACTER 


BEGIN_DEFINE CHARACTER starts a character definition block. This 
causes subsequent instructions to draw into the space associated 
with the given character, rather than drawing into the entire 
view surface. This instruction is paired with the 
END_DEFINE CHARACTER instruction. 


Opcode: 33 Length: 4 or 5 


Formats BEGIN DEFINE CHARACTER char-index, width, nom-width, 
nom-height, [left-offset] 


char-index The index of the character cell to be loaded. 
This value must be within the extent of the 
alphabet (See CREATE ALPHABET), or -1. 


width This field is used only if the font is defined 
as variable-width. It then specifies (in GOS 
units) the implicit movement that should be used 
for the character being defined. For example, 
if nom-width were 60, width for i would be about 
20 and width for m would be about 60. 


nom-width Nominal width. The number of GOS units to 
assign to alphabet width. 


nom-height Nominal height. The number of GOS units to 
assign to alphabet height. 


left-offset Identifies where the character is placed 
relative to the current position when it is 
drawn. Zero, the default, places the left edge 
of the character at the current position. 
Values greater than 0 move the cell left; values 
less than O move it right. Units of movement 
are the same as those for width. Left-offset is 
Specified in GOS units. 


Status: SUCCESS if the current alphabet is not equal to 0 and is 
not a loaded font, char-index is within the extent of 
the current alphabet, and there are sufficient resources 
to define this character; otherwise, FAILURE. 


BEGIN_DEFINE_CHARACTER 


Notes: 


Nom-width and nom-height select the natural shape of the 
Character. If the character definition contains a circle, 
thea drawing that character will yield a circle only when 
unit cell width and height are proportional to nom-width and 
nom-height. 


Besides affecting shape, nom-width and nom-height control 
resolution. For example, although 10 x 20 is the same shape 
as 100 x 200, the latter values give you finer drawing 
Control. 


To define the error character and any undefined character 
within a font, specify a char-index of -1. 


A character created by a character definition block can be 
manipulated (for example, scaled and rotated) like any other 
GIDIS character. 


You cannot use the following instructions inside a character 
definition block: 


BEGIN_DEFINE_CHARACTER 
LOAD _CHARACTER_CELL 
CREATE ALPHABET 

LOAD _BY_NAME 


If BEGIN_DEFINE_CHARACTER fails, GIDIS skips all subsequent 
instructions until it encounters an END_DEFINE_CHARACTER or 
INITIALIZE. This includes report handling instructions. For 
example, the following sequence will hang your program: 


BEGIN_DEFINE_CHARACTER that fails 
request. report 
END_DEFINE_CHARACTER | 

read report 


If left-offset is nonzero, the character should not be drawn 
in replace, complement negate, or overlay negate modes. 


To abort a character definition, send the INITIALIZE 
instruction with any argument (including 0). An INITIALIZE 0 
instruction aborts a character definition without affecting 
anything else. 


BEGIN_DEFINE_CHARACTER 


e This instruction implicitly saves all GIDIS attributes for 
the duration of the BEGIN_DEFINE_CHARACTER process. The 
END DEFINE CHARACTER instruction restores the saved GIDIS 
attributes. Table 6-1 lists the values in effect during the 
BEGIN_DEFINE_CHARACTER process. 


Table 6-1: Attributes Initialized by BEGIN DEFINE CHARACTER 
Attribute Value 

output IDS width nominal width 
output IDS height nominal height 
output viewport x origin 0 

output viewport y origin 0 

output viewport width nominal width 
output viewport height nominal height 
GIDIS output space x origin 0 

GIDIS output space y origin 0 

GIDIS output space width nominal width 
GIDIS output space height nominal height 
Output “clipping x origin 0 

output clipping y origin 0 

output clipping width nominal width 
output clipping height nominal height 
current position x 0 

current position y 0 

area texture solid 

line texture solid 

Logical. pixel x Obiset 0 

Logical pixel y--oFiSet 0 


1 hardware pixel 
1 hardware pixel 


logical pixel width 
logical pixel height 


cell unit size width nominal width 
cell unit size height nominal height 
cell display size width nominal width 
cell display size height nominal height 
cell movement mode flag 2 (imp ie Le) 


ee ee a eee 
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Attribute Value 

cell movement mode flag 2 (implicit) 
cell explicit movement dx 0 

cell explicit movement dy 0 

primary color di 

secondary color 0 

character cell all O’s 
plane mask 1 

writing mode overlay 


Device Notes: 


@e Plotter GIDIS does 


not store a character definition as a 


raster, but rather as a sequence of strokes. 


@® Except for Plotter GIDIS, a successful CREATE_ALPHABET 
instruction ensures sufficient resources to store the 
definition of the character. 


@® In Video GIDIS, do not allow the terminal subsystem to do a 
full screen scroll while defining a character. 


Example: This illustrates an entire character definitiion. 


.BYTE 4.,33. 


-BYTE a 
- WORD og 
- WORD 9.0). 


- WORD 225% 


. BYTE pep eo. 
. WORD O's 
- WORD £00), 


2BY iE «20 wy 2 Ox 


. WORD 40. 


sassume current alphabet is 1, storage 
*size of alphabet 1 is 9 by 9. 
slength = 4, 

;opcode for BEGIN_DEFINE_CHARACTER 
;defining character 3 

swidth 

snom-width 

;nom-height 

snow ready to draw into the 9 x 9 
;storage area using GOS of 

90 X 225. 

slength = 2, opcode for SET_POSITION 
>{0,100] is middle of left hand side. 


sintroduces uncounted argument list 


sopcode for DRAW_LINES 
+4042 0,0;) 
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BEGIN_DEFINE_CHARACTER 


WORD 200 H 

- WORD 80. ;([80,100] 
WORD 100 . 

. WORD 4Q. (40,0) 
WORD 0. : 

. WORD 0. -(0,100] 
WORD 100. : 

. WORD -32768. ;end list 


sthe four lines draw a diamond 
~-BYTE Qin Ors ;END_DEFINE CHARACTER 


Figure 6-1 illustrates the character defined by this example. 


Figure 6-1: Sample Character 


BEGIN_FILLED_ FIGURE 


6.2 BEGIN FILLED FIGURE 


BEGIN_FILLED_FIGURE starts the definition of a filled figure. 
Use DRAW_LINES, DRAW_REL_ LINES, DRAW_ARCS, and DRAW REL ARCS to 
enter positions in the filled figure table. Positions are stored 
in the order given. A corresponding END_FILLED_FIGURE 
instruction is required to actually fill the figure. 


Opcode: 31 Length: 0 
Format: BEGIN FILLED FIGURE 
Status: SUCCESS 


Notes: 


@® BEGIN_FILLED_FIGURE sets the filled figure flag to TRUE. 


@® You should not use the following PRO/GIDIS instructions 
between a BEGIN_FILLED_FIGURE instruction and its 
corresponding END_FILLED_FIGURE. (However, this is an 
unenforced restriction. ) 


BEGIN FILLED FIGURE 
DRAW_CHARACTERS 
DRAW_PACKED CHARACTERS 
SET_GIDIS_OUTPUT_SPACE 
SET _OUTPUT_IDS 

SET OUTPUT _VIEWPORT 
SET POSITION 

SET REL POSITION 


e The filled figure table must contain at least 1 user-provided 
point for any drawing to occur. You can enter up to 255 
points in the filled figure table. When GIDIS receives the 
END_FILLED_FIGURE instruction, it adds the original current 
position twice, as the first and last points of the figure. 
Thus, GIDIS automatically closes figures for you. 


e If you specify too many points, GIDIS uses only the first 255 
points. GIDIS ignores points that exceed the capacity of the 
filled figure table. 


@e An edge of the filled area is not guaranteed to be identical 
to a line drawn through the same points, due to differences 
in drawing direction and round-off errors. 


BEGIN FILLED FIGURE 


@® You may draw lines that cross earlier lines in the filled 


figure table. 
the examples below. 
a bow tie. 


@® GIDIS attributes used in doing the fill are: 


Only the enclosed areas will fill. 


Contrast 


The first creates a square; the second, 


primary color, 


secondary color, writing mode, plane mask, area texture cell, 


area cell size, 


and area texture size. 


@ Complement and complement-negate writing modes can give 
unexpected results when filled figure areas overlap or abut. 


e To abort a filled figure definition, 
instruction with any argument 


INITIALIZE 
An INITIALIZE 0 


send the 
(Including. 0). 


instruction aborts a filled figure definition without. 
affecting anything else. 


@ No drawing is done by the BEGIN_FILLED_FIGURE 


Examples 


Ae any ch 
- WORD 
- WORD 
Bie 


so LE 
- WORD» 
- WORD 
- WORD 
- WORD 
- WORD 
- WORD 


Pop a le sk 


TASCYUCEIT ON. 


;Length=2,opcode for SET_POSITION 
;Current position 

> now [100,100] | 
>Length=0,opcode for BEGIN_FILLED_FIGURE 
;filled figure table now has [100,100] 
;Length=4,opcode for DRAW_REL_LINES 

ee p.aie 

edy i 

OZ 

Say 

-dx3 

rae Wes 

sAdds points. [200,100 ), 
= cand (100,200) -to 

; the filled figure table 
sLength=0,opcode for END_FILLED_FIGURE 
;Adds point [100,100] to table 

>The area defined by [100,100], 

E200. 2007; 1 200;20015 (200,200) ;.-and 
(100,100]--a square--is filled with 
the current area texture governed by 
the following writing attributes: 
writing mode, color map entry, 

plane mask, primary color, 

secondary color. 


(200,200); 


™=e “se se Bs “6 


=e 


BEGIN_FILLED_ FIGURE 


Figure 6-2 illustrates the filled figure created by this example. 


Figure 6-2: 


Example: 


By DE 
- WORD 
- WORD 
,DY LE 


Pe Qa a 
- WORD 
- WORD 
- WORD 
- WORD 
- WORD 
- WORD 


DY TE 


Sample Filled Figure Square 


;Length=2,opcode for 
;Current position 

; now [100,100] 
;Length=0,opcode for BEGIN_FILLED_FIGURE 
;filled figure table now has [100,100] 
;Length=4,opcode for DRAW_REL_LINES 
-dxi 

pdyi 

OZ 

;dy2 

Aes 

sdy3 

;Adds points [200,200], 
> -and {1003200 ) to 

; the filled figure table 


SET POSLTLION 


(200,100), 


;Length=0,opcode for END_FILLED_FIGURE 
;Adds point [100,100] to table 

;The area defined by [100,100], 

y (200.200); 12200, 100)% 1100-2004 and 
[100,100]--a bow tie--is filled with 
the current area texture governed by 
the following writing attributes: 
writing mode, color map entry, 

plane mask, primary color, 

secondary color. 


> @ se 6 = @ ™~e “Be or) 


BEGIN FILLED FIGURE 


Figure 6-3 illustrates the filled figure created by this example. 


Figure 6-3: Sample Filled Figure Bow Tie 


CREATE_ALPHABET 


6.3 CREATE ALPHABET 


CREATE_ALPHABET reclaims resources used for the current 
alphabet’s font and _ reserves resources for a new font with the 


indicated storage size. Storage size in bytes is: 30 + (extent 
* 2) + (width/8 rounded up) * height * (extent + 1). See 
Appendix C. 


Opcode: 46 Length: 4, 5, or 6 


Format: CREATE_ALPHABET width, height, extent, flags, 
[initialize], [ave-width] 


width Is an integer in the range (0 to 64) that 
Specifies the number of horizontal bits ina 
character pattern. 


height Is an integer in the range (0 to 64) that 
Specifies the number of vertical bits ina 
Character pattern. 


extent Is an integer that specifies the number of 
Characters in the alphabet. Character indices 
can range from 0 to extent-1, (or 32 to extent 
+31, if bit 8 of flags is set). 


flags Is a word that specifies one or more of the 


character renditions and font attributes. Table 
6-2 lists the supported renditions. 


Table 6-2: CREATE ALPHABET Flags 


Cell Rendition Bit Value 
Italics 1 | Z 
Bold 3 8 
Proportionally spaced 4 16 
ASCII 8 250 


CREATE ALPHABET 


If ASCII (bit 8) is set, you do not have to 
include indices Q through 31 in the font, and 
the error character is automatically associated 
with those indices. 


initialize W to initializes all characters in the newly 
created font. If 0, initialize to blank. If 
not-0s initialize to ‘solid: If not present, 


initialize to solid. 


ave-width Is the average width in pixels of glyphs in this 
font « It is not a true average, but an 
indication of how many characters fit on an 
average line of text when this font is used. If 


not specified, width is used. 


Status: SUCCESS if width is 0 to 64, height is 0 to 64, current 
alphabet number is 1 to 15, extent is greater than or 
equal to 0, storage size is less than 64 KB, and _ there 
are sufficient resources to create the alphabet; 
otherwise, FAILURE. 


Notes: 


e To only reclaim the memory used for an alphabet’s current 
font, execute a CREATE ALPHABET instruction with width, 
height or extent set to Q. 


e If alphabet 15 is current, CREATE_ALPHABET creates a region 
CRESAL. See the description of the GIFONT routine in Chapter 
4, 


® The largest allowable storage size on the Professional is 
64KB. If you create a font whose total size is greater than 
8KB, the total extent must be less than or equal to 512. 


e Specify ave-width for proportionally spaced fonts; width for 
monospaced fonts. 


@e When describing a font in an .FDF file (see Appendix D), use 
ave-width for proportionally spaced fonts and width for 
monospaced fonts. 


e The true limits for font width and height are: (width in 
bytes) * (height) may not be greater than 512; height may not 
be greater than 80. 


@ SET_CELL_UNIT_SIZE uses ave-width, when trying to select the 
best font. 


CREATE _ALPHABET 


Device Notes: 


@® For Plotter GIDIS, no storage is reserved when a 
CREATE ALPHABET is done. Space is reserved per character as 
character definition blocks are processed. 


Example: 
;Current alphabet is alphabet number 2 
BYTE 4.,46. ;Length=4, opcode for CREATE_ALPHABET 
. WORD £0: ;width 
. WORD 16:4 ;height 
. WORD 32a sextent 
- WORD 8. ;rend-type boid 


;Reclaims space occupied by alphabet 2’s 
; current font, allocates space for a 

> new font, and initializes each 

; character in the font to a solid 

; block (because the initialize argument 
; 1s omitted). 


DRAW_ARCS 


6.4 DRAW ARCS 


The DRAW_ARCS instruction draws one or more circular arcs 
starting from the current position around the specified 
center(s). 

Opcode: 23 Length: 3N 


Formats DRAW_ARCS x, y, angle 


xX Specifies the x coordinate of the arc’s center 
point 

4 Specifies the y coordinate of the arc’s center 
point 

angle The angle for the arc is given in degrees, with 
a positive value meaning counter-clockwise with 
respect to the view surface. For example, an 


angle of zero means no drawing is done; +360 or 
-360 means a full circle is drawn. 


Status: SUCCESS if angle is from -360 to +360 and there is no 
Filled figure table overflow; otherwise, FAILURE. 


Notes: 


@ DRAW_ARCS is a repeatable instruction. You can, for example, 
draw three connected arcs by specifying: x1, yl, anglel, x2, 
y2, angle2, x3, y3, angle3. The coordinates can be specified 
either in a counted argument list (with the count supplied in 
the opcode word), or in an uncounted argument list (with 255 
in the opcode word and an END_LIST instruction after the last 
argument). See END_LIST. 


@e GIDIS draws an arc as a series of straight lines. The 
PRO/GIDIS interpreter calculates one line endpoint per 10 
degrees of arc (or portion thereof), regardless of the size 
of the circle. 


e If the filled figure flag is TRUE then, instead of drawing 
the arc, all internally calculated line endpoints are added 
to the friled figure. table. 


@e The current position is left at the end of the arc, whether 
the instruction returns SUCCESS or FAILURE. 


DRAW_ARCS 


@e Full quadrant arcs (1/4 circle) always end at the exact point 
expected. Fractional quadrant arcs end at the closest 
available point. Multiple fractional quadrant arcs are not 
guaranteed to end at the exact point predicted by your 
program. For example, a full circle drawn as a 103 degree 
arc and a 257 degree arc is not guaranteed to leave the 
current position exactly where it started. 


@ DRAW_ARCS is affected by the following GIDIS attributes: 
writing mode, primary color, plane mask, secondary color, 
pixel size, line texture, and filled figure flag. 


@ DRAW_ARCS modifies the view surface only inside the clipping 
rectangle. 


Example: 
;Not in a filled figure definition 
;(filled figure flag is FALSE) 
;Current position is [500,300] 


-BYTE 3.,23. j;Length=3, opcode for DRAW_ARCS 


. WORD 400. >x coordinate of center 
. WORD 30:0: ;y coordinate of center 
. WORD 180. 7180 degrees is one-half a circle 


> (counter-clockwise) 

;Draws the top half of the circle 
centered at [400,300] with radius 100 
;Middle of the arc is [400,200] 

;New current position is [300,300] 


Figure 6-4 shows the arc created by this sample program. 


Figure 6-4: Sample Arc 


Example: 


Example: 


2B UE 


- WORD 
- WORD 
- WORD 


BYTE 


- WORD 
- WORD 
- WORD 


DRAW_ARCS 


;Not ina filled figure definition 
;(filled figure flag is FALSE) 
;Current position is [500,300] 


;Length=3, opcode for DRAW_ARCS 


:x coordinate of center 

;y coordinate of center 

;90 degrees is one-fourth of a circle 
; (clockwise) 

;Draws a quadrant 

scentered at [100,300] with radius 400 
*-Middle of the arc is [300,400] 

;New current position is [100,700] 


;Inside a filled figure definition 
; (filled figure flag is TRUE) 
;Current position is [500,300] 


;Length=3, opcode for DRAW_ARCS 


Center is [400,300] 


;90 degrees = 1 quadrant 

sAdds eight line endpoints 
;(internally calculated) 

;plus [400,400] to filled 

;figure table 

;New current position is [400,400] 


DRAW_CHARACTERS 


6.5 DRAW_CHARACTERS 


The DRAW_CHARACTERS instruction draws the character identified by 
the specified character index. The character is taken from the 
currently selected alphabet. 


Opcodes 35 Lengths: N 

Format: DRAW _CHARACTERS char-index 
char-index Is an unsigned 16-bit word 

Status: SUCCESS 

Notes: 


@® DRAW_CHARACTERS is a repeatable instruction. You can, for 
example, draw several characters in succession by specifying: 
char-indexl, char-index2, char-index3, . : . char-indexn. 
You can specify characters in either a counted argument list 
(with the count supplied in the opcode word) or in an 
uncounted argument list (with 255 in the opcode word and an 
END_LIST after the last argument.) See END_LIST. 


@e DRAW_CHARACTERS is affected by several attributes: unit and 
display cell size, cell slant, cell rotation, rendition mask, 
current alphabet, writing mode, primary and secondary color, 
and plane mask. 


e If the specified character index is outside the extent of the 
current alphabet, the error character is drawn. Unless 
otherwise specified in the font itself, the error character 
is a checkerboard. 


e The current position is updated after a character is drawn 
according to the cell movement controls. (See the 
descriptions of the SET_CELL_MOVEMENT_MODE and 
SET CELL EXPLICIT MOVEMENT instructions. ) 


e To delete a proportionally spaced character, specify erase 
writing mode, specify mirrored text by negating the display 
cell width, and then redraw the character. 


e When using local symmetry, the current position after a 
DRAW CHARACTERS instruction could be different from that 
calculated by your program. It is suggested that any series 
of DRAW_CHARACTERS instructions be followed by a SET_POSITION 
instruction or a REQUEST POSITION instruction, unless you do 
not care exactly where the string ends. 
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DRAW_CHARACTERS 


@ DRAW_CHARACTERS modifies the view surface only inside the 
clipping rectangle. 


e See also DRAW_PACKED_ CHARACTERS. 


Example: 
;Current alphabet = 0 (DEC Multinational) 
.BYTE 3.2439 ;Length=3, opcode for DRAW_CHARACTERS 
. WORD 65 ~ oy 
.WORD 66. - 1B 
. WORD 67% pee Oras 
* Draws A, B, C from current font for 
; alphabet 0 
Example: 


;Current alphabet = 1 (user-defined) 
BYTE 255.,35. j;introduces uncounted argument list 
opcode for DRAW_CHARACTERS 


e 
a 


. WORD 0: 

. WORD 13 

. WORD Tx 

. WORD 45. 

. WORD -32768. ;END_LIST 


*;Draws 4 characters from alphabet 1, 
which are user-defined characters 


e 
sf 


DRAW_LINES 


6.6 DRAW_LINES 


The DRAW_LINES instruction draws a straight line from the current 
position to the specified endpoint. The endpoint is specified as 
an absolute coordinate pair. 

Opcodes 25 Length: 2N 


Formats DRAW_LINES xend, yend 


end Specifies the x coordinate of the line’s 
endpoint 

yend Specifies the y coordinate of the line’s 
endpoint 


Status: SUCCESS, provided no filled figure table overflow 
occurs; on overflow, FAILURE. 


Notes: 


@e The DRAW_LINES instruction is repeatable. You could, for 
example, draw 3 connected lines by specifying: xendi, yendi, 
xend2, yend2, xend3, yend3. The coordinates can be specified 
either in a counted argument list (with the count supplied in 
the opcode word), or in an uncounted argument list (with 255 
in the opcode word and an END_LIST instruction after the last 
argument). See END_LIST. 


@ The DRAW_LINES instruction is affected by the following 
drawing attributes: writing mode, primary color, plane mask, 
secondary color, pixel size, line texture, and filled figure 
flag. 


e When the filled figure flag is TRUE, this instruction does 
not draw a line from the current position to the specified 
point. Instead, it tries to insert [xend, yend] into the 
filled figure table. 


e The current position is updated whether the instruction 
returns SUCCESS or FAILURE. 


e In complement and complement negate modes, the first pixel of 
a line is skipped and the last pixel is drawn. But if [xend, 
yend] is itself the current position, the 1 pixel is drawn. 


@e DRAW_LINES modifies the view surface only inside the clipping 
rectangle. 


Examples: 


Example: 


Example: 


Example: 


«BYTE 
- WORD 
- WORD 


-BYTE 
- WORD 
- WORD 
- WORD 
- WORD 


eo iy 


- WORD 
- WORD 
. WORD 


ep op Ga lal 
- WORD 
- WORD 
- WORD 
- WORD 


200. 


DRAW_LINES 


;Not in a filled figure definition 
;(filled figure flag is FALSE) 
;Current position is [200,300] 
;Length=2, opcode for DRAW_LINES 
Draw a line from [200,300] 

“tO: £150,200 


;New current position is [150,200] 


scurrent position is [150,200] 

snot ina filled figure definition 
;Length=4, opcode for DRAW_LINES 

sxendl 

;yendl 

sxend2 

;yend2 

*Draw lines from [150,200] to [600,-10] 
sthen from [600,-10] to [300,10] 

;New current position is [300,10] 

*Note that both the -10 and the +10 are 
sabsolute coordinates. 


“Current pesition 1s. 1300,;10] 
snot in a filled figure definition 


~;introduces uncounted argument list 


;opcode for DRAW_LINES 

sxendi 

;yendl 

sENDLIST terminator value 

“Draws a line from [300,10] to [400,40] 


;New current position is [400,40] 


*Inside a filled figure definition 
(filled figure flag is TRUE) 
opcode for DRAW_LINES 


;Length=4, 
sxendl 
;yendl 
sxend2 
;yend2 
;The points [300,200] and [300,300] 
;added to the filled figure table 
snew current position is [300,300] 


ave 


DRAW_PACKED_CHARACTERS 
6.7 DRAW_PACKED_ CHARACTERS 


DRAW_PACKED_ CHARACTERS makes drawing of ASCII strings more 
efficient, because it enables you to pack two ASCII characters 
into one word. You can use DRAW_PACKED CHARACTERS for non-ASCII 
alphabets, if the indices are less than 255. It uses the low 
order byte before the high order byte. Otherwise, 
DRAW_PACKED_ CHARACTERS is equivalent to DRAW_CHARACTERS. 


Opcode: 74 Lengths N 

Formats DRAW _PACKED CHARACTERS 2charindex 
2charindex 1s two 8-bit character indices 

Status: SUCCESS 

Notes: 


@ DRAW_PACKED_ CHARACTERS is appropriate for any alphabet whose 
extent is less than 255. 


@ A character index of 255 explicitly performs no operation. 
Thus, if you want to draw 1 character, place 255 in the high 
order byte of the argument. 


@ Using a DRAW_PACKED_CHARACTERS instruction with repeated 
arguments is the fastest way to draw a long string with 
GIDIS. 


@ DRAW_PACKED_ CHARACTERS is a repeatable instruction. 
Characters can be specified either in a counted argument list 
(with the count supplied in the opcode word) or in an 
uncounted argument list (with 255 in the opcode word and an 
END_LIST after the last argument). 


e The current position is updated after a character is drawn, 
accoeding to the cell movement controls. (See 
SET_CELL_ MOVEMENT_MODE and SET CELL EXPLICIT _MOVEMENT. ) 


® To delete a proportionally spaced character, specify erase 
writing mode, specify mirrored text by negating display cell 
width, and then redraw the character. 


@e When using local symmetry, the current position after a 
DRAW_PACKED CHARACTERS instruction could be different from 
that calculated by your program. It is suggested that any 
series of DRAW_PACKED_CHARACTERS instructions be followed by 


DRAW_PACKED_CHARACTERS 


a SET POSITION instruction or a REQUEST_POSITION instruction, 
unless you do not care exactly where the string ends. 


@e The DRAW_PACKED_CHARACTERS instruction is affected by several 
attributes: unit and display size, cell slant, cell 
rotation, rendition mask, current alphabet, writing mode, 
primary and secondary color, and plane mask. 


e If the specified character index is outside the extent of the 
current alphabet, the error character is drawn. Unless 
otherwise specified in the font itself, the error character 
is a checkerboard. 


@e DRAW_CHARACTERS modifies the view surface only inside the 
clipping rectangle. 


Example: 


;assume current alphabet is 0 
. BYTE Cee ;length=3 words,opcode for 
» DRAW_PACKED CHARACTERS 
.BYTE 116.,101. ;’t’', ‘e’ 
. BYTE ti Say b1Os. 2S" 7" 
-BYTE AQ.wdoos. # “Ly “MO character™ 
sdraws the string "testi" 


Example: 
sBYTE <14:°38:. s;length=1, opcode for SET_ALPHABET 
.WORD 1. ;alphabet 1 
wBYTE 2oSw,~ 4 ;introduces uncounted argument list 
;opcode for DRAW_PACKED_CHARACTERS 
eBYETE (Ovcg ace sdraw characters 0,1 
~-WORD -32768. ;draws characters that you defined in 


sindex 0 and 1 of alphabet 1 


DRAW_REL_ARCS 


6.8 DRAW_REL_ARCS 


DRAW_REL_ARCS draws a circular arc from the current position 
around the specified center. 


Opcode: 27 Lengths: 3N 


Format: DRAW_REL_ARCS dx, dy, angle 


Specifies the x coordinate of the arc’s center 
point as: x of current position + dx 


dy Specifies the y coordinate of the arc’s center 
point as: y of current position + dy 
angle The angle for the arc is given in degrees, with 


a positive value meaning counter-clockwise with 
respect to the view surface. An angle of zero 
means no drawing is done; +360 or -360 means a 
full circle is drawn. 


Status: SUCCESS, if angle is within a range of -360 to +360 and 


there is no filled figure table overflow or arithmetic 
overflow; otherwise, FAILURE. 


Notes: 


An arc is drawn as a series of straight lines. The PRO/GIDIS 
interpreter calculates one line endpoint per 10 degrees of 
arc (or portion thereof), regardless of the size of the 
C1rcie.. 


If the filled figure flag is TRUE, instead of drawing the 
arc, all internally calculated line endpoints are added to 
the filled figure table. 


DRAW_REL_ARCS is a repeatable instruction. You can, for 
example, draw three connected arcs by specifying: dx1, dyl, 
angle1, dx2, dy2, angle2, dx3, dy3, angle3. The coordinates 
can be specified either in a counted argument list (with the 
count supplied in the opcode word), or in an uncounted 
argument list (with 255 in the opcode word and an END_LIST 
instruction after the last argument). See END_LIST. 


The current position is left at the end of the last arc. 


DRAW_REL_ ARCS 


@e Full quadrant arcs (1/4 circle) always end at the exact point 
expected. Fractional quadrant arcs end at the closest 
available point. Multiple fractional quadrant arcs are not 

guaranteed to end at the exact point predicted by your 
program. For example, a full circle drawn as a 103 degree 
arc and a 257 degree arc is not guaranteed to leave the 
current position exactly where it started. 


® DRAW_REL_ARCS is affected by the following GIDIS attributes: 
writing mode, primary color, plane mask, secondary color, 
pixel size, line texture, and filled figure flag. 


@ DRAW_REL_ARCS modifies the view surface only inside the 
clipping rectangle. 


Example: 


;Current position is [400,300] 
;filled figure flag is FALSE 

sBYTE 3.,27. j;Length=3,opcode for DRAW_REL_ARCS 

. WORD -100. Center is [-100,+30] 

. WORD +30. ;Relative to current position 

. WORD -90. ;90 degrees = one quadrant (clockwise) 
;Draws one quadrant from [400,300] to 
>{330,430] centered at [300,330] 
;New current position is [330,430] 


Example: 


;Current position is [330,430] 
;filled figure flag is FALSE 
BYTE 6.,27. ;Length=3, opcode for DRAW_REL_ARCS 


. WORD +35. : 

. WORD -50. ;Center is [+35,-50] 

. WORD 90. ;[{365,380], 90 degree arc 

. WORD -35. ;Current position is now [415,415] 
. WORD +50. ;Center is 380,465] 

. WORD 90. ;90 degrees 


;draws a lens shaped object with two 
FCLYCuUlLar arcs. 


DRAW_REL_LINES 


6.9 DRAW_REL_LINES 


The DRAW_REL_LINES instruction draws a straight line from the 
current position to the specified endpoint. The endpoint 
coordinates are specified relative to the current position. 


Opcodes: 26 Length: 2N 
Formats DRAW_REL_LINES dxend, dyend 


dxend Specifies the x coordinate of the line’s 
endpoint as: current position + dxend 


dyend Specifies the y coordinate of the line’s 
endpoint as: current position + dyend 


Status: SUCCESS, if no last pair arithmetic overflow or filled 
figure table overflow occurs; on overflow, FAILURE. On 
success, the current position is set to [x of current 
position + dxend, y of current position + dyend]. On 
failure, the current position is not changed. 


Notes: 


@e The DRAW_REL_LINES instruction is repeatable. You can,for 
example, draw 3 connected lines by specifying: dxend1i, 
dyendi, dxend2, dyend2, dxend3, dyend3. The coordinates can 
be specified either in a counted argument list (with the 
count supplied in the opcode word), or in an uncounted 
argument list (with 255 in the opcode word and an END_LIST 
instruction after the last argument). See END_LIST. 


e The DRAW_REL_LINES instruction is affected by the following 
drawing attributes: writing mode, primary color, plane mask, 
secondary color, pixel size, line texture, and filled figure 
flag. 


DRAW_REL_LINES 


@e When the filled figure flag is TRUE, this instruction does 
not draw a straight line from the current position to the 
specified point. Instead, it tries to insert [x of current 
position + dxend, y of current position + dyend] into the 
filled figure table. No drawing occurs until the 
END_FILLED_FIGURE instruction is processed. 


@® In complement and complement negate mode, the first pixel of 
a line is skipped and the last pixel is drawn. But if [x of 
current position + dyend, y of current position + dyend] is 
itself the current position, the one pixel is drawn. 


e DRAW_REL_ LINES modifies the view surface only inside the 
clipping rectangle. 


Examples 

s;Not in a filled figure definition 
;(filled figure flag is FALSE) 
;Current position is [100,100] 

.BYTE 4.,26 ;Length=4, opcode for DRAW_REL_LINES 

. WORD +10. :dxend1 

. WORD -10 ;dyend1l 

. WORD +30 *dxend2 

. WORD +15 ;dyend2 
*-Draw lines from [100,100] to [110,90] 
sand from [110,90] to [140,105] 
;New current position is [140,105] 

Example: 

;Current position is [140,105] 
snot in a filled figure definition 

«BYTE 255.,26. ;introduces uncounted argument list 
;opcode for DRAW_REL_LINES 

. WORD Oe edxendl 

. WORD -30 ;dyend1 

. WORD 20: ;dxend2 

. WORD +60. ;dyend2 

. WORD -32768 ;END_LIST 
*Draw line from [140,105] to [150,75] 
sand then to [170,135] 
;New current position is [170,135] 


Example: 


«BYTE 
- WORD 
- WORD 
- WORD 
. WORD 


DRAW_REL_LINES 


;Inside a filled figure definition 

; (filled figure flag is TRUE) 
;Current position is [100,100] 
;Length=5, opcode for DRAW_REL_LINES 
sdxendl 

;dyend1 

;dxend2 

;dyend2 

;Adds the points [200,100] and [200,200] 
;to the filled figure table 

;New current position is [200,200] 


END_DEFINE_ CHARACTER 


6.10 END DEFINE CHARACTER 


END_DEFINE CHARACTER terminates a character definition block and 
restores the GIDIS attributes saved by the BEGIN_DEFINE_CHARACTER 


instruction. 
Opcodes: 36 Length: 0 
Formats END DEFINE CHARACTER 


Status: SUCCESS if character definition flag is TRUE; otherwise, 
FAILURE. 


Notes: 


@® The defined character can now be used like any other 
character in DRAW_CHARACTERS and DRAW_PACKED_ CHARACTERS. 


Device Notes: 


® In Video GIDIS, while you are defining a large character, all 
but its bottom 16 lines (32 in high resolution mode on the 
Professional 380) are visible at the bottom of the screen. 
When END_DEFINE_CHARACTER is processed, the area occupied by 
the character is set to current secondary color. 


Examples See BEGIN_DEFINE_CHARACTER. 


END_FILLED FIGURE 


6.11. END FILLED FIGURE 


END_FILLED_FIGURE terminates the definition of a closed figure, 
and fills the figure. This instruction is used in conjunction 
with the BEGIN_FILLED_FIGURE instruction. 


Opcode: 32 Length: 0 
Formats END_FILLED_FIGURE 


Status: SUCCESS if there is at least one point in the filled 
figure table; otherwise, FAILURE. 


Notes: 


e The filled figure table must contain at least 1 user-provided 
point for any drawing to occur. GIDIS provides the initial 
current position twice, at the beginning and end, thereby 
automatically closing the figure. 


e If you specify too many points, GIDIS uses only the first 255 
points, and draws a straight line connecting the 255th point 
with the initial current position. (255 is the maximum 
number of user-provided points in the filled figure table.) 


e The current position is unchanged by END_FILLED_FIGURE. The 
current position remains wherever the last drawing 
instruction in the figure block set it. 


@e END FILLED FIGURE turns off the filled figure flag. 


e This instruction modifies the view surface only inside the 
clipping rectangle. 


Examples See BEGIN_FILLED_FIGURE 


END_LIST 


6.12 END LIST 


END_LIST indicates the end of an uncounted argument list. This 
instruction follows the last argument in the list. The PRO/GIDIS 
instructions often used with an uncounted argument list are: 
DRAW_LINES, DRAW_REL_LINES, DRAW_ARCS, DRAW_REL_ARCS, 
DRAW_CHARACTERS, DRAW_PACKED CHARACTERS, 


Opcodes 128 Length: must be 0 
Formats END_LIST 
Statuss SUCCESS 


Notes: 


@ You specify an uncounted argument list by placing a length of 
255 in an instruction’s opcode word. 


@ 128 * 256 + 0 equals -32768. Thus, -32768 may not be the 
value of an argument word in an uncounted argument list. 
However, -32768 is valid as an argument in a counted argument 
list. For example, the point [-32768,0] could not be sent in 
a DRAW_LINES instruction terminated by an END_LIST 
instruction, but could be sent in a DRAW_LINES instruction 
with counted arguments. 


Example: 


.BYTE 255.,25. ;length=255 is a special value that 
does not indicate 255 data words 
following, but that there are an 
unknown number of words 
following, to be terminated 

> with the END_LIST instruction. 
;opcode for DRAW_LINES 


6 % @ ~™ @ ™=e = 9 


- WORD £00 ;DRAW_LINES data 
.WORD 110. ;DRAW_LINES data 
-WORD -32768. ;END_LIST 


END_PICTURE 


6.13 END PICTURE 


END_PICTURE logically terminates the current picture. The action 
performed by END_PICTURE depends on the current device. 


Opcode: 24 Length: 0 
Formats END_PICTURE 
Status: SUCCESS 

Notes: 


e It is recommended that you use NEW_PICTURE and END _PICTURE to 
enclose the instructions used in drawing a picture. 


@e END_PICTURE simulates a FLUSH BUFFER instruction. 
Device Notes: 


e For a GIDIS that builds a virtual bitmap (for example, 
Palette GIDIS), END_PICTURE causes the bitmap to be output to 
the device. 


@® For Sixel GIDIS, an END _ PICTURE does a formfeed. However if 
you are using the VDM interpreter to print the picture as 
part of a document, the formfeed is suppressed. 


e For Palette GIDIS, an END_PICTURE advances the film, provided 
you are not passing the picture through the VDM interpreter. 


e For Plotter GIDIS, an END_PICTURE advances the paper (or 
ejects the paper in the case of single sheet feed), provided 
you are not passing the picture through the VDM interpreter. 


END_PICTURE 


;length=0,opcode for NEW_PICTURE 


g 


;drawing instructions 


, 

;length=0,opcode for END_PICTURE 
;wait for operator response 
;perhaps 

;length=0,opcode for NEW_PICTURE 


g 


;more drawing instructions 


v 


ERASE CLIPPING REGION 


6.14 ERASE CLIPPING REGION 


ERASE_CLIPPING_REGION sets every pixel inside the current 
clipping rectangle to the current secondary color. This 
instruction provides a way to clear an area without implying the 
beginning of a new picture. 

Opcode: 48 Lengths: 0 

Format: ERASE CLIPPING REGION 

Status: SUCCESS 


Notes: 


@® Do not use this instruction as a substitute for NEW_PICTURE 
and END_PICTURE. 


® You should use ERASE CLIPPING REGION, rather than 
BEGIN_FILLED_ FIGURE and END_FILLED_FIGURE to clear a 
rectangular area of the view surface. 

e® The current writing mode, current area texture, and primary 
color do not affect this instruction. However, plane mask 
does. 

Device Notes: 
e Plotter GIDIS ignores ERASE_CLIPPING_REGION. 


Examples: 


.BYTE 0.,48. j;Length=0, 
sopcode for ERASE_CLIPPING_REGION 


FLUSH_BUFFER 


6.15 FLUSH BUFFER 


FLUSH_BUFFER forces execution of any pending GIDIS processing. 
Opcode: 28 Length: 0 

Formats: FLUSH BUFFER 

Status: SUCCESS 


Notes: 


e FLUSH _BUFFER enables you to ensure that all previous drawing 
instructions have been executed prior to requesting operator 
response or the like. 


Example: 


-BYTE 0.,28. ;length=0,opcode for FLUSH_BUFFER 


INITIALIZE 


6.16 INITIALIZE 


INITIALIZE restores PRO/GIDIS subsystems to their default states. 
Also, if a character definition block or filled figure block is 
active, INITIALIZE aborts it. 


Opcode: i Length: 1 
Format: INITIALIZE sub-mask 


sub-mask Is a word that specifies zero or more of 
PRO/GIDIS’s subsystems. The subsystems defined 
at this time are listed in Table 6-3. A 
subsystem is represented in the mask value as a 
bit, as shown in the table. For example, a 
value of 6 (bit 2 + bit 1) resets text and 
writing attributes. 


Status: SUCCESS 


Table 6-3: Initialization of Subsystems 


Subsystem Description Bit Value 


Addressing Sets IDS, Viewport, GOS 0 1 
and clipping region to 960 
x 600. Also sets all 
attributes that specify 
distances or coordinates 
(for example, unit cell 


size). 
Writing Reinitializes writing 1 Z 
Attributes mode, primary color, 


secondary color, line and 
area texture, planes 
selected, and pixel size. 


INITIALIZE 


Subsystem Description Bit Value 
Text Resets the current 2 4 


alphabet, unit size, 
display size, cell 
rotation, cell rendition, 
implicit cell movement 
flag; and explicit. ceil 
movement. 


Color Map Reinitializes the color 4 16 
map. 
Alphabet Clears all user-defined 5 ae 


alphabets and sets family 
ID of alphabet 0 to 
“DGIDES": 


Cursor Resets the output cursor 8 256 
and output rubber band. 


Notess 


@® INITIALIZE 0 is useful, as it aborts any blocks begun with 
BEGIN_FILLED_FIGURE and BEGIN_DEFINE_ CHARACTER without 
affecting any GIDIS subsystems. 


@e You can combine mask bits to initialize multiple subsystems 
in one instruction. 


e A mask of -1 decimal (177777 octal) initializes all 
subsystems. 


@e The order of initialization is: (1). addressing, (2) writing 
attributes, (3) text, (4) color map, (5) alphabet storage, 
and (6) cursor. 


e .GID files that use default text attributes may not come out 
as expected, because some defaults are appropriate only for 
Video GIDIS. 


e Table 6-4 lists all of the GIDIS attributes affected and 
their values after initialization. Note that some attributes 
are included in more than one subsystem. All coordinates and 
distances are in GOS, unless otherwise noted. 


INITIALIZE 


Table 6-4: Values of GIDIS Attributes After an INITIALIZE 


Attribute Value 


Addressing Subsystem 


output IDS width 960 

output IDS height 600 

output viewport x origin O° ifr DS 
output viewport y origin 0 in IDS 
output viewport width 96.0. an. IDS 
output viewport height 600 in IDS 
GIDIS output space x origin 0 

GIDIS output space y origin 0 

GIDIS output space width 960 

GIDIS output space height 600 

oucput clipping x origin 0 

output clipping y origin 0 

output clipping width 960 

output clipping heignt 600 
current position x 0 

current position y 0 

line texture s1zZe N/A 

area texture width 5 

area texture height 25 


logical pixel width QO (1 hardware pixel) 
logical pixel height OQ (1 hardware pixel) 
logical pixel x: ortset Q 
logical pixel y offset ) 


cell movement mode flag 2 (ample: et) 
cell explicit movement dx 0 

cell explicit movement dy 0 

cell display size width 12 

cell display size height aes 

cell unit size width 12 

cell unit size height ie) 


INITIALIZE 


Attribute 
Writing Attributes Subsystem 


primary color 
secondary color 
plane mask 
writing mode 


logical pixel width 
logical pixel height 
logical pixel x offset 
logical pixel y offset 


line texture pattern 


line 
line 


area 
area 
area 
area 


Text 


texture length 
texture s12ze 


texture alphabet 
texture character 
texture width 
texture height 


Subsystem 


current alphabet 


cell 
cell 


cell 
cell 


cell 
cell 
cell 


cell 
cell 
cell 


display size width 
display size height 


unit size width 
unit size height 


rotation 
oblique 
rendition 


movement mode flag 
explicit movement dx 
explicit movement dy 


Value 


7 

0 

all available planes 
overlay 


Ooo © 


solid (all ones) 
N/A 


ho 


(implicit) 


CO © 


INITIALIZE 


Attribute Value 
Color Map Subsystem (values associated) 

R G B M Color Mono 
color map [0] -O .0 .0 .0 black (dark) 
color map [1] 2 .2 .6 .2 blue (dk. gray) 
color map [2] st «2 2 «3. red (lt. gray) 
color map [3] 2 .7 .2 .4 green (light) 
color map [4] 6 .6 .6 .7 white (light) 
color map [5] 6 .6 .6 .7 white (light) 
color map [6] -6 .6 .6 .7 white (light) 
color map [7] -6 .6 .6 .7 white (light) 
Alphabet Storage Subsystem 
family name of alphabet 0 "DGIDIS" 

. Cursor Subsystem 

output cursor alphabet -1 

output cursor character index N/A 

output cursor width N/A 

output cursor height N/A 

output cursor x offset N/A 

output cursor y offset N/A 

output cursor rendition blinking 

output rubber band type none 

Examples: 
. BYTE 6 ears Cee ;length=1,opcode for INITIALIZE 
. WORD ete 'a 3 ;addressing, writing attributes, 


sand text subsystems mask bits 
sare set 


LOAD_BY_NAME(1) 


6.17 LOAD BY NAME(1) 


LOAD_BY_NAME(1) loads a pre-built font into the current alphabet. 


Ble! 


e€ 


argument list is a pair of words which contain a region name 


in Radix-50. 


Opcode: 37 Length: 2 


Formats LOAD BY NAME(1) name-0, name-1l 


name -0O 3 radix-50 characters 


name-1 3 radix-50 characters 


Statuss SUCCESS if the region named identifies a valid region, 


the region has the proper format, the current alphabet 
number is not 0, and there are sufficient resources to 
load the font region; otherwise, FAILURE. 


Notes: 


Subsequent SET_ALPHABET instructions do not affect previous 
LOAD_BY_NAME INSTRUCTIONS. For example, if you loaded font 
MYALPH into alphabet 1, it would remain alphabet 1’s font 
until INITIALIZE 32, another LOAD BY NAME, or a 
CREATE_ALPHABET was processed for alphabet 1. 


a 
a 
£ 


f no such region can be found or installed, GIDIS simulates 
LOAD_BY NAME(2) and loads "DGIDIS", the default family ID 
or alphabet QO. 


A GIDIS font file is an RSX Common Library. In other words, 


i 


nstalling a GIDIS font file creates a font region. 


A font region must conform to the format shown in Appendix C. 


A font region can be accessed in one of 3 ways: 


Le 


Prior to doing the LOAD _BY NAME(1), you can create and 
load the region in your application. 


Prior to doing the LOAD_BY_NAME(1), you can install a 
Font file with the DCL INSTALL command, PROTSK, or your 
application installation file (.INS). 


You can rely on GIDIS to install the region’s font file 
when the LOAD _BY_NAME(1) is done. You enable GIDIS to 
install the file in either of two ways: 


LOAD BY _NAME(1) 


1. Place the font file on LB:[ZZFONT] and name it 
region-name.TSK. (Note: $’s and .’s in a region 
name become Z’s in the filename). 


2. Describe the font in an .FDF file. See Appendix D. 


Example: 
BYE 2.,37. ;length=2, opcode for LOAD_BY_NAME 
~-Radix-50 "BOLD";let MACRO-11 compute the Radix-50 for 
BOLD 

Examples 
SBYTE Ta ee a >Radix-50 for MYALPH 
. WORD 050500+001750+000001 >MYA 
. WORD 045400+001200+000010 ; LPH 


LOAD _BY_NAME(2) 


6.18 LOAD BY NAME(2) 


LOAD_BY_NAME(2) associates the current alphabet with the 
specified font family. When a subsequent DRAW_CHARACTERS or 
DRAW_PACKED CHARACTERS is done, GIDIS finds the font file in the 
family that best matches the current GIDIS text attributes. See 
Appendix D. 


Opcode: 37 Length: 3 to 7 
Format: LOAD BY NAME(2) Chi, Ch2, Ch3, ...Chn 
Chi - Chn Is a font family ID, encoded as 1 character per 
word 


Statuss SUCCESS 


Notes: 


@® Subsequent SET_ALPHABET instructions do not affect previous 
LOAD_BY_ NAME instructions. For example, if you loaded family 
ID MYALPH into alphabet 1, it would remain alphabet 1’s 
family ID until INITIALIZE 32, another LOAD _BY_NAME, ora 
CREATE_ALPHABET was processed for alphabet 1. 


e The default family ID for alphabet 0 is DGIDIS. 


@e Family IDs are mapped to uppercase. For example, specifying 
"dgidis" is equivalent to specifying "DGIDIS". 


@ A font must be described in an .FDF file on LB:[ZZFONT] to be 
accessible via a LOAD_BY_NAME(2) (see Appendix D). 


e If the specified family has no members, GIDIS simulates a 
LOAD _BY_NAME(2) "DGIDIS." 


Example: 
.BYTE Deore Os ;Length=1,opcode for SET_ALPHABET 
- WORD de. ;Selects alphabet 1 as current alphabet 
2BVEER 6 2y3:ls ;Length=6,opcode for LOAD_BY_NAME 
WORD 68 8) 
WORD 71 7G 
WORD 73 oo 
WORD 68 °D 
WORD voce ail 
- WORD G3: ;5,associates alphabet 1 with family 


;LD) " DGIDIS* 


6-42 


LOAD _CHARACTER_CELL 


6.19 LOAD CHARACTER CELL 


LOAD_CHARACTER_CELL defines a character cell from the specified 
data. This instruction acts on the current alphabet. 


Opcode: 34 Length: 2 +N 
Formats LOAD CHARACTER CELL char-index, width, dO, di,...,dn 


char-index The index of the character cell to be loaded. 
This value must be in the range 0 to extent-i, 
where extent is the total character count for 
the current alphabet. 


width The width value must be in the range 0 to _ the 
width value given with the CREATE_ALPHABET 
instruction that established the alphabet. 


ag03. Gl...<dna zero or more words of data to be loaded into the 
Character cell. The top character cell row is 
loaded from the first data word(s), the second 
row from the next data words, and so forth. 
Excess data words are ignored, and missing data 
words are assumed to be 0’s. Each row of the 
cell is (alphabet width + 15)/16 data words. 
For example, an 8-bit wide alphabet has 1 word 
per row, and a 20-bit wide alphabet has 2 words 
per row. 


Status: SUCCESS if not within a character definition block (See 
BEGIN_DEFINE_ CHARACTER), character index 1S in range 
(see CREATE ALPHABET), width is in the range QO to 
alphabet width, and a CREATE_ALPHABET has been done for 
the current alphabet; otherwise, FAILURE. 


Notes: 
e The defined character can now be used like any other 
character in SET AREA TEXTURE, SET_OUTPUT_CURSOR, 
DRAW_CHARACTER and DRAW_PACKED CHARACTER instructions. 


e The leftmost pixel in a row comes from the low-order bit in 
the appropriate data word. 


LOAD_CHARACTER_CELL 


Examples: 


;Alphabet 2 has width of 5, height of 6, 
and extent of 10 


e 
P 


-BYTE 7.,34. ;Length=7, opcode for LOAD_CHARACTER_CELL 


- WORD a. ;Character index (last cell in alphabet) 
. WORD oe >Width 

. WORD *BOOOO01 ;Pattern: ON -- -- -- -- 
- WORD BO OOUa . 3 ON ON -= == -~— 
.WORD *B00101 (Note the ON -- ON _- -- 
- WORD ~BOLOOL bit reversal) ON -- ~ ON —- 


ON ON ON ON ON 


8 38 = 6 a) 


- WORD sa! Cas tae I 


v 


;Last row not given; set to Q’s 
;automatically. 
;Character is a triangle 


NEW_PICTURE 


6.20 NEW_PICTURE 


NEW_PICTURE indicates the beginning of a new picture. 
Opcode: 6 Length: 0 

Formats: NEW_PICTURE 

Statuss SUCCESS 

Notes: 


@® It is recommended that you use NEW_PICTURE and END_PICTURE to 
enclose the instructions used in drawing a picture. 


@e Secondary color is written to the view surface subject to the 
plane mask in effect at the time NEW_PICTURE executes. (See 
SET PLANE _MASK. ) 


@® A NEW_PICTURE clears all of hardware address space, 
regardless of the current clipping region. In particular, it 
clears the 32-pixel bands on both sides of the screen not 
normally used in Video GIDIS. 


Device Notes: 


Oo NEW_PICTURE does not affect picture background in Plotter 
GIDIS. | 


Example: 


.-BYTE Qos 510 :« s;length=0,opcode for NEW_PICTURE 


NOP 


6.21 NOP 


NOP performs no operation. Execution of a NOP has no effect on 
the current state of PRO/GIDIS, other than to set the status flag 
CO: SUCCESS. 
Opcode: 0 Length: 0 
Formats NOP 
Status: SUCCESS 
Note: 
e This instruction is useful for transparently inserting 
information from a higher level protocol into a stream of 


GIDIS instructions. Use a nonzero length, when you want to 
insert information. | 


Examples 
2BYTE O sg 0s ;length=0,opcode for NOP 
Example: 
_BYTE 2440 ;length=2,opcode for NOP 
. WORD 1540. ;private data (ignored by PRO/GIDIS) 
- WORD ree ;private data (ignored by PRO/GIDIS) 


PRINT_SCREEN 


6.22 PRINT SCREEN 


PRINT_SCREEN sends the specified portion of the video bitmap to a 
sixel printer connected to the printer port. 


Opcodes: 141 Lengths: 6 or 7 
Formats PRINT_SCREEN x, y, width, height, hxly, dxly, [mask] 


x Specifies the leftmost horizontal coordinate of 
the GOS data to be printed 


y Specifies the uppermost vertical coordinate of 
the GOS data to be printed 


width Width of the area to be printed 
height Height of the area to be printed 
hxly Specifies the horizontal offset from the current 


printhead location to where you want to begin 
printing the screen data. 


dxly Specifies the vertical offset from the current 
printhead location to where you want to begin 
printing the screen data. 


mask Specifies the color indexes that cause printing 
a dot on the paper. The low order bit is color 
0, the next bit color 1, and so on. If mask i185 
omitted, it is generated as_ follows. In a 
single plane system (no EBO), a pixel value of 0 
is mapped to a skip (leaves paper white) anda 1 
is mapped to a strike (prints on the paper). On 
multi-plane systems, the value of the color map 


is tested as follows. If the entry (color index 
of point) equals 0, the point is skipped 
(white). If not 0, the point prints. 


Status: SUCCESS 
Notes: 
® Applies to Video GIDIS only. 


e If the printer port does not have a sixel printer connected, 
nothing occurs. 


PRINT SCREEN 


Example: 


BYTE 6.,141. ;Length=6, opcode for PRINT_SCREEN 


.WORD 100. ;Upper left bitmap corner 

. WORD 10.0: ; is [100,100] 

. WORD 400. ;Data to be printed is 400 units wide 
. WORD 200: ; by 200 Units. high 

. WORD O.. ;Begin printing at current printhead 
- WORD Oe location 


REQUEST_CELL STANDARD 


6.23 REQUEST CELL STANDARD 


REQUEST_CELL_STANDARD reports the GOS dimensions you would have 
to specify to generate a standard size character. A standard 
Size character has dimensions such that when its width/height = 
8/5, 80 characters fit across the device and 24 lines fit 
vertically, 

Opcodes 54 Lengths: 0 

Formats REQUEST CELL STANDARD 

Status: SUCCESS 


The report consists of 5 words: 


Report Header, unit-wd, unit-ht, display-wd, display-ht 


where 
unit-wd Is the unit cell width of the standard size 
character. 
unit-—-ht Is the unit cell height of the standard size 
character. 
display-wd Is normally the same as unit-wd. However if the 
current alphabet is 0, this value is 11/12 of 
the current cell width. 
display-ht Is normally the same as unit-ht. However if the 
current alphabet is 0, this value is 11/12 of 
the current cell height. 
Notes: 


@e This instruction takes into account the storage size of the 
current alphabet and the character rotation currently in 
effect. As a result, the standard size for alphabet 0 (DEC 
Multinational) is not necessarily the same as the standard 
Size for a user alphabet. 


@e Rounding could take place converting from device coordinates 
to GIDIS space. If your program later sets unit cell size to 
‘n’ times the size of the standard, the characters actually 
formed might not be precisely ‘'n’ times the standard. 


Example: 


-BYTE 


0; 


,o4. 


REQUEST_CELL_ STANDARD 


;opcode for REQUEST_CELL_ STANDARD 


° 
g 


;Length=0, 
Byte 4. 
Byte 5. 
Word 9. 
Word 20 
Word 8. 
Word 20 


™=e 26 Se Be BS WS 


(Data words following) 
(Cell Standard Rpt. Tag) 
(Unit-wd) 

(Unit-ht) 

(Display-wd) 
(Display-ht) | 


REQUEST_CURRENT_POSITION 


6.24 REQUEST CURRENT POSITION 


REQUEST_CURRENT_POSITION reports the absolute location of the 
current position in GIDIS Output Space. The current position is 
the display location at which the next character, line, or arc 
would be drawn. 


Opcode: 55 Length: 0 

Formats: REQUEST CURRENT POSITION 

Statuss SUCCESS 

The report consists of 3 words: 
Report header, current x, current y 


Notes: 


e The current position is not necessarily the same as the last 
position given to SET_POSITION or DRAW_LINES; DRAW_CHARACTERS 
and DRAW_ARCS instructions also move the current position. 


@® REQUEST_CURRENT_POSITION is most useful following a DRAW_ARCS 
or a DRAW_CHARACTERS (local symmetry), Since your program 
cannot determine precisely where PRO/GIDIS leaves the current 
position after these instructions. 


Examples 


.BYTE O27 55 sLength=0, 
;opcode for REQUEST_CURRENT_POSITION 
>This instruction causes the following 
; report to be placed in the report 
>; queue if there is sufficient room. 


; Byte 2. Data words following 

; Byte 1. Current Position Report Tag 
- Word x PRO/GIDIS coordinates 

; Word y for the current position 


REQUEST_OUTPUT_SIZE 


6.25 REQUEST OUTPUT SIZE 


REQUEST_OUTPUT_SIZE reports the attributes of the current 
device’s view surface. 
Opcode: 57 Length: 0 
Formats: REQUEST _OUTPUT_SIZE 
Status: SUCCESS 
The report consists of 10 words: 
Report header, Us, ULY', screen_width, screen_height, 
total width, total_height, resolution_x, resolution_y, 
Total_plane_mask 
where 
Pulx; uly) Are the coordinates of the upper left 
corner of the device’s view surface in IDS 
units 
Screen_width Is device width in IDS units 
Screen_height Is device height in IDS units 
Total width Is device width in IDS units 
Total_height Is device height in IDS units 
Resolution_x Is device width in HAS x units 
Resolution_y Is device height in HAS y units 
Total_plane_mask Is the plane mask that contains L:- Ox 
every plane accessible. See device notes 


of SET_PLANE_MASK. 


REQUEST_OUTPUT_SIZE 


Examples: 


;Assume PRO 350 Video with EBO 
;Assume IDS is 960 by 600 
.BYTE Quis wed ;length=0,opcode for REQUEST_OUTPUT_SIZE 


g 

*BYTE 
; 

*BYTE 
WORD 
eWORD 
WORD 
; WORD 
; WORD 


e 
»WORD 


°1024. 


g 
eWORD 


; WORD 


9 words following output size 
report tag 

OUTPUT_SIZE_REPORT tag 

IDS coordinate of device’s 
upper left corner is [-32,0] 
IDS width and height of 
entire view surface 

IDS width and height of 
entire view surface 


number of pixels in total 
device width 

number of pixels in total 
device height 

total plane mask 


REQUEST_STATUS 


6.26 REQUEST STATUS 


REQUEST_STATUS reports the success or failure of the last 
PRO/GIDIS instruction. All PRO/GIDIS instructions set the status 
variable. 


Opcode: 58 Length: 0 

Formats: REQUEST_STATUS 

Status: SUCCESS 

The report consists of 2 words: 
Report header, status 

where the low-order bit of the status word is either 
1 - indicating SUCCESS 
QO - indicating FAILURE. 

Notes: 


@ No other codes are defined. (Codes other than 0 or i are 
reserved for future uSe.) 


@ FAILURE status is not saved. If your program needs 
information about the success or failure of every 
instruction, you must place a REQUEST_STATUS instruction 
after each PRO/GIDIS instruction. 


e Testing is recommended only following major PRO/GIDIS 
instructions, such as CREATE ALPHABET. 


Examples: 


;assumes previous instruction failed 
.BYTE 03.4200 ;Length=0, 

;opcode for REQUEST_STATUS 

; Byte 1. (Data words following) 

; Byte 4. (Current Status Report Tag) 

; Word Q (FAILURE status) 


REQUEST_VERSION_NUMBER 


6.27 REQUEST VERSION NUMBER 


The REQUEST_VERSION_NUMBER instruction reports the version number 
and driver of PRO/GIDIS. 


Opcode: 71 Length: 0 
Formats REQUEST_VERSION_NUMBER 
Statuss SUCCESS 

The report consists of 3 words: 


Report header, driver, version 


where 
driver Is 21 for Video GIDIS, 
22 for Plotter GIDIS, 
23 for Sixel GIDIS, 
24 for File GIDIS, 
25 for Palette GIDIS. 
version Is the version number of GIDIS. 
Notes: 


e For P/OS V2.0, the version number of GIDIS is 21. 
e For P/OS V2.0A, the version number of GIDIS is 29. 
e For P/OS V3.0, the version numer of GIDIS is 32. 
Example: 


.BYTE Oy Tis ;Length=0, 
;opcode for REQUEST _VERSION_NUMBER 
;byte 2. data words following 
;byte 7. VERSION_NUMBER_REPORT tag 
sword 21. device code 
sword 25. version number 
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6.28 SCROLL _CLIPPING REGION 


The SCROLL _CLIPPING_REGION instruction moves data within the 
clipping region. The vacated display area is set to the current 
secondary color. 


Opcode: 52 Length: 2 
Formats SCROLL _CLIPPING_REGION dx, dy 


dx The distance to move the data horizontally. Ef 
dx is positive, the data is shifted right to 
left; if negative, the data is shifted left to 
rignt. 


dy The distance to move the data vertically. If dy 
1S positive, the data is shifted toward the top 
of the screen; if negative, the data is shifted 
toward the bottom of the screen. 


Status: SUCCESS 
Notess 
e The instruction applies to Video GIDIS only. 


@ SCROLL _CLIPPING_REGION is affected by the current plane mask. 
Planes not selected are not scrolled or otherwise changed. 


@e For speed, hardware assist is used when possible. When the 
clipping rectangle is all of IDS, a vertical scroll scrolls 
the entire width of the screen. 


@® When a software scroll is done, screen images appear to move 
around rather than scroll. 


@e The data scrolled out is not saved. You cannot scroll out a 
portion of an image and then scroll it back in. Solid 
secondary color always scrolls in. 


@e After this instruction, shaded areas within the clipping 
region will not necessarily be aligned with shaded areas 
outside the clipping region. 


Example: 


Example: 


Example: 


me oi ll 


. WORD 
- WORD 


BY LE 
- WORD 
- WORD 


~BYTE 
- WORD 
- WORD 


SCROLL CLIPPING REGION 


;Length=0, 

;opcode for SCROLL_CLIPPING_REGION 
ax 

; dy 

;Slides data to the right 100 units 


Scroll data down 
°15 units 


;Scrolls data in the clipping region 
730° units: left and. 30: ‘units up. 
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6.29 SET ALPHABET 


SET_ALPHABET sets the current alphabet to the specified alphabet. 
Except as noted below, all alphabet-related operations act on the 
currently selected apphabet. 


Opcode: 38 Length: 1 
Format: SET_ALPHABET alphabet 


alphabet Is an integer value in the range 0 to 15. It 
identifies the alphabet to make current. 


Status: SUCCESS if the alphabet number is valid (from 0 to 15); 
otherwise, FAILURE. 


Notes: 


e A GIDIS alphabet number is somewhat like a character set. 
Alphabet 0 is the DEC Multinational Character Set. Alphabets 
1 through 15 are user alphabets. 


e The first time you select a nonzero alphabet number, there is 
no font for the alphabet. You get a font in one of two ways: 
the LOAD BY NAME instruction or the CREATE ALPHABET 
instruction. 


@® SET_OUTPUT_CURSOR and SET_AREA_ TEXTURE are the only alphabet 
related operations that do not act on the current alphabet. 


@ No drawing is done by the SET_ALPHABET instruction. 
Examples: 
«BYTE 1.,38. ;Length=1, opcode for 
>SET ALPHABET 


. WORD o Selects alphabet #2 as current 
;alphabet 
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6.30 SET AREA CELL SIZE 


SET_AREA_ CELL_SIZE clips the current area texture cell. 
Opcodes 69 Length: 2 
Formats: SET AREA CELL SIZE width, height 


width The width of the area cell in hardware pixels. 
The width value must be in the range 1 to 16. 


height The height of the area cell in hardware pixels. 
The height value must be in the range 1 to 16. 


Status: SUCCESS if both width and height are in the range 1 to 
16; otherwise, FAILURE. 


Notes: 

e If the area cell width is greater than the specified width, 
GIDIS removes columns from the right side of the area texture 
cell. 

e If the area cell height is greater than the specified height, 
GIDIS removes columns from the bottom of the area texture 
cell. 

e The SET _AREA TEXTURE and SET_AREA_TEXTURE_SIZE instructions 
set the area cell size from that of the character cell, 
overriding any previous SET_AREA_CELL_SIZE specification. 

e No drawing is done by the SET_AREA_CELL_SIZE instruction. 


Device Notes: 


e Plotter GIDIS ignores this instruction. 


Example: 


BYTE 
- WORD 
. WORD 


-BYTE 
- WORD 
. WORD 


SET_AREA_CELL_SIZE 


;Length=2, opcode for SET_AREA_ TEXTURE 
;Use character 23 from alphabet 2, 
swhich is 8 x 10 

;Area Cell Size is now 8 by 10 | 
;Length=2, opcode for SET_AREA_CELL_SIZE 
;area cell width = 9 hardware pixels 
;area cell heighth = 9 hardware pixels 
;Area cell size is now 9 by 9, padded on 
;the right, with one column of OFF’s, and 
swith the bottom row of the character 
scell removed 
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6.31 SET_AREA_TEXTURE 


SET_AREA_TEXTURE specifies the rectangular bit pattern used _ to 
fill subsequent filled figures. Area texture is specified as a 
character in an alphabet. 


Opcode: 14 Length: 2 
Format: SET_AREA TEXTURE alphabet, char-index 


alphabet The number of the alphabet containing the 
texture character. It can be the DEC 
Multinational character set (alphabet 0), a 
user-defined alphabet, or the special texture 
alphabet -1. 


char-index The index of the character to use. 


Status: SUCCESS if the specifie alphabet number is valid; 
otherwise, FAILURE. | 
Notes 


e The character identified by SET_AREA_TEXTURE is copied to an 
internal GIDIS storage area. Deleting or changing the font 
does not affect the current area texture. Only another 
SET_AREA_TEXTURE or SET_AREA_TEXTURE_SIZE can change the 
current area texture. 


e Alphabet -1 char-index 0 asks GIDIS to derive the area 
texture cell from the current line texture. The pattern is 
drawn vertically and replicated horizontally. The area 
texture height is taken from the line texture size, not from 
the area texture width and height. 


e Solid fill is more efficient than patterned fill. To 
generate solid fill most efficiently, select alphabet -1, 
character 0Q while line texture is set to solid. 


e Filling is most efficient when area texture width is 8 or 16. 


e If the selected alphabet is associated with a family ID (See 
LOAD_BY_NAME(2)), SET_AREA_TEXTURE chooses a font for you 
using the current area texture size. This option gives you a 
way Of making GIDIS generate more consistent patterns across 
devices of differing resolutions. 
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The current font of the specified alphabet should not have 
width or height greater than 16 pixels. If width is greater 
than 16, only the leftmost 8 bits of the selected glyph are 
used. If height is greater than 16, only the topmost 16 
lines of the glyph are used. If the alphabet is associated 
with a family ID, the selected font is guaranteed to be less 
than or equal to 16 x 16, if the current family contains such 
a font. 


The bit pattern specified by this instruction always appears 
upright; there is no way to rotate the pattern. 


Area textures are self-aligning. When two adjacent or 
overlapping areas are filled, no seams show. 


Complement and complement-negate writing modes can give 
unexpected results when filled figure areas overlap or abut. 


Pixel size is not used when filling areas. 


No drawing is done by the SET_AREA_TEXTURE instruction. 


Device Note: 


Plotter GIDIS processes SET_AREA_TEXTURE differently. See 


® 
Appendix E for a description of how Plotter GIDIS handles 
this instruction. 
Examples: 
.BYTE 25/44 slength=2., opcode for SET_AREA_ TEXTURE 
. WORD 8. ;User-defined alphabet 2 
. WORD 25% 23rd character 
Examples: 


.BYTE Ceara! Oe ;length=3.,opcode for SET_LINE_TEXTURE 


. WORD any ;length of pattern 

. WORD -1 -sobid 

-WORD any ;size of one repetition of pattern 

-BYTE yarns a slength=2.,opcode for SET_AREA_ TEXTURE 

. WORD -1 ;alphabet -1 is derived from line texture 
. WORD 0 character 0 


;sets up solid area fill 
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6.32 SET AREA TEXTURE SIZE 


SET_AREA TEXTURE_SIZE specifies the desired size of the area 
texture cell. 


Opcode: 3 Length: 2 
Formats SET_AREA_TEXTURE_SIZE width, height 


width Specifies the width of one repetition of the 
area texture cell. 


height Specifies the height of one repetition of the 
area texture cell. 


Status: SUCCESS if width and height are greater than zero; 
otherwise, FAILURE. 


Notes: 


e If the glyph you select (perhaps with GIDIS’s help as 
described in the next note) for the area texture cell is 
smaller than the specified width and height, GIDIS scales the 
selected glyph to the size you specified. However, scaling 
is restricted to an integral multiple of the texture cell. 
GIDIS uses the largest multiple that is not larger than the 
Size specified. If the glyph you select is larger than the 
specified width and height, GIDIS uses the selected glyph as 
Sc 

e If the selected alphabet is associated with a family ID (see 
LOAD BY _NAME(2)), SET_AREA_TEXTURE_SIZE chooses a font for 
you using the current area texture. This option gives you a 
way of making GIDIS generate more consistent patterns across 
devices of differing resolutions. 

@e No drawing is done by the SET_AREA_TEXTURE_SIZE instruction. 


Device Notes: 


e Plotter GIDIS ignores this instruction. 


Example: 
.BYTE ee. ;length=2, 
;opcode for SET_AREA_TEXTURE_SIZE 
. WORD sae sArea texture width = 12 units 
. WORD 8. ;Area texture height = 8 units 
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6.33 SET _CELL_DISPLAY SIZE 


SET_CELL_DISPLAY_SIZE defines the size of a character’s display 
cell, the rectangular area of the view surface modified when a 
character is drawn. 


Opcode: 40 Length: 2 

Format: SET_CELL_ DISPLAY SIZE width, height 
width Is the width of the display cell. 
height Is the height of the display cell. 

Statuss SUCCESS 

Notes: 


e The origin of the display cell is always the upper left 
corner of the cell and is aligned with the unit cell at that 
corner. 


e Normally display cell size and unit cell size are set the 
same. One reason to make display cell width wider than unit 
cell size is to space characters further apart. (See 
implicit movement in SET_CELL_MOVEMENT_MODE.) In Replace 
Writing mode this approach can be preferable to using 
SET_CELL_EXPLICIT_MOVEMENT, because there will not be gaps 
between the cells. 


e® If the unit cell is smaller than the display cell, all of the 
character is drawn and the right and bottom portions of the 
display cell are treated as 1f the character pattern 
specified OFF. 


e if the unit cell is larger than the display cell, the bottom 
and right portions of the character are clipped to the 
display cell size. In other words, the character is 
truncated. 


Figure 6-5 shows what happens when the unit cell and display 
cell are not the same size. 


SET_CELL_DISPLAY SIZE 
uals! 
, Display Size 
LARGER THAN 
Limit Size 
| 


Display Size 


i) ae ee 


Size 


SMALLER THAN 


Umit BSize 


bb Display 


Size 


Figure 6-5: Character Unit Cell and Display Cell 


Negative values in width or height produce a mirroring in X 
and Y, respectively. This mirroring always occurs about the 
origin (the upper-left corner of the cell). Implicit 
movement always goes across the display cell; consequently, 
implicit movement for a display cell mirrored in X is in the 
opposite direction from the rotation angle. 
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e The smallest actual width or height is 1 hardware pixel. 


@e Display cell size, except for mirroring, is ignored for 
proportionally spaced fonts. 


@e No drawing is done by the SET_CELL DISPLAY SIZE instruction. 
Example: 
sBYTE 2.,40. ;Length=2, 
;opcode for SET_CELL_ DISPLAY SIZE 


. WORD ee *Width 
. WORD ZB ;Height 
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6.34 SET _CELL_EXPLICIT MOVEMENT 


SET_CELL_EXPLICIT_MOVEMENT specifies a distance to move the 
current position after a character is drawn. 


Opcodes: 41 Length: 2 
Formats: SET_CELL_EXPLICIT_MOVEMENT dx, dy 


dx Specifies the horizontal distance to move the 
current position. 


dy Specifies the vertical distance to move the 
current position. 


Status: SUCCESS 


Notes: 


e Dx and dy define the total movement when implicit movement is 
OFF (see SET_CELL MOVEMENT_MODE. ) 


@e Explicit cell movement is not affected by SET_CELL_ROTATION 
or SET CELL OBLIQUE instructions. 


e For left-to-right text, you normally use either implicit 
movement or explicit movement as follows: 


Implicit Movement 


.-BYTE cs eZ ;Length=1,opcode for 

*SET CELL MOVEMENT MODE 
. WORD Z flag for implicit movement 
.BYTE Dargie ;length=2,opcode for 

-SET CELL EXPLICIT MOVEMENT 
. WORD 0 Ox 
. WORD 0 ;dy 


Explicit Movement 


.BYTE sere ;length=1,opcode for 

>SET_ CELL _MOVEMENT_MODE 
- WORD O(or 1) ;turns off implicit cell movement 
.BYTE 22441 >length=2,opcode for 

>SET CELL EXPLICIT MOVEMENT 
-WORD width ;as set by SET_CELL_DISPLAY_SIZE 
. WORD 0 ; 


SET CELL EXPLICIT MOVEMENT 


e No drawing is done by the SET_CELL_EXPLICIT_MOVEMENT 


instruction. 
Example: 
.BYTE 2.,41. ;Length=2,opcode for 
,oET CELL EXPLICIT MOVEMENT 
. WORD ioe Ox 
. WORD O. ;day 


SET_CELL MOVEMENT _MODE 


6.35 SET CELL MOVEMENT MODE 


SET_CELL_MOVEMENT_MODE specifies the manner in which the current 
position moves after a character is drawn. | 


Opcode: 42 Length: 1 
Formats SET_CELL_ MOVEMENT_MODE flag 


flag Specifies one of the following movement modes as 
Shown in Table 6-5 below. 


Table 6-5: SET _CELL_ MOVEMENT MODE Flag Values 
Movement Mode Value 


Explicit cell movement, 0 
local symmetry 


Explicit cell movement, Ht 
global symmetry 


Explicit and implicit movement, 2 
local symmetry 


Explicit and implicit movement, 2 
global symmetry 


Reserved 4-15 


Status: SUCCESS if Flag is 0 to 3; otherwise, FAILURE. 
Notes: 
@e Explicit cell movement is set by SET_CELL_EXPLICIT_MOVEMENT. 
e Implicit movement means that the current position moves a 
distance equal to the display cell width. Movement is along 
the baseline of the angle of rotation. Thus, left-to-right 


text (aligned along a 0 degree angle) has implicit movement 
of dx = display cell width and dy = 0. Each successive 
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character is one display cell width to the right. Upwards 
perpendicular text (text aligned along a 90 degree angle), 
has implicit movement of dx = 0 and dy = -display cell width. 
Each successive character is one display cell width towards 
the top of the view surface. 


When using local symmetry, the current position after a 
DRAW_CHARACTERS instruction could be different from that 
calculated by your program. It is suggested that any series 
of DRAW_CHARACTERS instructions be followed by a SET_POSITION 
instruction or a REQUEST_POSITION instruction, unless you do 
not care exactly where the string ends. 


When using global symmetry, the final current position is 
exactly the value that would be calculated by your program. 
However, character spacing may not always be even due to 
round-off errors. 


For proportionally spaced fonts, you should normally specify 
implicit motion. 


If the current font is proportionally spaced, global symmetry 
is ignored. 


No drawing is done by the SET_CELL_MOVEMENT_MODE instruction. 


Example: 


.BYTE 1.,42. ;Length=1, 
;opcode for SET_CELL_MOVEMENT_MODE 
. WORD 0:3 ;Set explicit movement, local symmetry 


SET_CELL_OBLIQUE 


6.36 SET CELL OBLIQUE 


Normally a character cell is a rectangle. An oblique character 
cell is a parallelogram. SET_CELL_OBLIQUE specifies how much to 
slant the rectangle. The top line of the display cell remains 
stationary, while the bottom of the cell is moved either forward 
or backward. 


Opcode: 65 Length: 1 
Format: SET_CELL_ OBLIQUE angle 


angle The requested angle in degrees. A positive 
angle value indicates a backward slant (move 
bottom of cell forwards); a negative angle 
indicates a forward slant (move bottom of cell 
backwards) | 


Status: SUCCESS 
Notes: 


e If the specified angle is greater than 60 (or less than -60), 
GIDIS uses 60. 


@e The shape of the parallelogram is not affected by cell 
rotation. 


e If x of the current position is at the left edge of the 
clipping rectangle, the bottom left of a forward-slanted 
character will be clipped. This is because a forward slant 
is achieved by moving the bottom of the cell backwards, 
rather than by moving the top of the cell forwards. 


® No drawing is done by the SET_CELL_OBLIQUE instruction. 


Example: 
.BYTE 1.,65. ;Length=1, opcode for SET_CELL_OBLIQUE 
. WORD -23. sApproximate italics (slant right 
723 degrees) 
Example: 
.BYTE 1.,65. ;Length=1, opcode for SET_CELL_OBLIQUE 
. WORD 23% ;Approximate back-slant (slant left 
;23 degrees 
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Figure 6-6 shows the two display cells that result from the above 
examples. 


B Sw. 


Figure 6-6: Italic and Back-Slanted Display Cells 
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6.37 SET CELL RENDITION 


SET_CELL_ RENDITION controls character rendition. The rendition 
options defined for the Professional are: back-slant, italics, 
bold, and proportionally spaced text. 


Opcode: 43 Lengths: 1 
Formats: SET_CELL_ RENDITION flags 
flags A word that specifies zero or more of the cell 
FEeNGCitLONn: <options. A rendition is represented 
by the value of set bits as shown in Table 6-6. 


A Q value establishes normal rendition: no 
slant, not. bold; net proportional: 


Table 6-6: SET CELL RENDITION Flags 


Cell Rendition | Bit Value 


Back Slant 0 d: 
Ltadaes 1 Z 
Bold 3 8 
Proportionally spaced 4 16 
Reserved 2y S215 


Status: SUCCESS 


SET_CELL_ RENDITION 


Notes: 


SET CELL RENDITION is not cumulative. A SET_CELL RENDITION 
with an argument of 2 followed by another SET_CELL_RENDITION 
with an argument of 8 causes the character to be bold not 
Slanted, rather than bold and slanted. 


e SET_CELL_RENDITION with an argument of 3 (mask value BO00011) 
selects italics. 

e SET_CELL_ RENDITION simulates a SET_CELL OBLIQUE with an 
argument of 0, before processing the mask-value. This 
cancels the effect of earlier SET _CELL_OBLIQUE instructions. 

e If possible, GIDIS satisfies a request for bold or italics by 
using a font with that attribute. Otherwise, it 
algorithmically creates the desired rendition. 

e If font width size is less than or equal to 8 pixels, 
algorithmic bolding has no visible effect. 

e Algorithmic italics is equivalent to SET_CELL_OBLIQUE -23. 

e Algorithmic backslant is equivalent to SET_CELL_OBLIQUE 23. 

e There is no algorithmic fallback for proportionally spaced 
text. The proportional bit is used only to request a 
proportional font from a font family. If no appropriate font 
is found, the argument is ignored. See LOAD_BY_NAME(2). 

e For proportionally spaced fonts, you should normally specify 
implicit motion. 

e If the current font is proportionally spaced, global symmetry 
is ignored. 

Example: 


-BYTE pee oe ;Length=1, opcode for SET_CELL_RENDITION 
- WORD 2% ;Requests italics rendition 
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6.38 SET CELL ROTATION 


SET_CELL_ROTATION defines the angle of rotation with which 
subsequent characters are drawn. The character is rotated about 
the current position (upper left corner of the display cell) to 
the angle specified. 


Opcode: 44 Length: 1 
Formats SET_CELL_ ROTATION angle 
angle The requested angle in degrees. A positive 

angle value indicates counter-clockwise from 
normal text. For example, 90 degree text 15 
Sideways, facing up. A negative angle indicates 
Clockwise from normal text. 

Status: SUCCESS 


Notes: 


@ The simplest way to make a string of rotated characters 
follow a baseline is to use SET_CELL_EXPLICIT_MOVEMENT with 
arguments of [0,0] and set the implicit movement flag with 
the SET _CELL_MOVEMENT_MODE instruction. 


@e An angle of N-360 is equivalent to an angle of N. 


@e No drawing takes place when the SET_CELL_ROTATION instruction 


executes. 
Example: 
-BYTE Ley oh ;Length=1, opcode for SET_CELL_ROTATION 
. WORD -90. -Text to face down the screen 
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6.39 SET CELL _UNIT SIZE 


SET _CELL_UNIT_SIZE specifies the size to draw subsequent 
character cells. 


Opcodes: 45 Lengths: 2 
Formats: SET_CELL_UNIT_SIZE width, height 


width Is the desired cell width. The width must be 
greater than zero. 


height Is the desired cell height. The height must _ be 
greater than zero. 


Status: SUCCESS if width and height are greater than zero; 
otherwise, FAILURE. 


Notess 


e If the current alphabet is associated with a font family ID 
(See LOAD _BY_NAME(2)), GIDIS tries to find a font in the 
Family whose size matches the specified size. If the size 
request is between two available fonts, GIDIS generally 
selects the smaller of the two. 


® If the current alphabet has a CREATE ALPHABET font or a 
LOAD BY NAME(1) font, GIDIS must use that font. 


® If the available (or chosen) font does not match the 
specified size, GIDIS scales it. Width and height are scaled 
independently. 


® GIDIS may not be able to scale the font exactly to the 
specified size. However, unit cell size will not be exceeded 
unless the specified size is less than half the size of the 
font being scaled. 


@® The width of a proportionally spaced font can only be scaled 
to an integral multiple of itself. 


® The requested unit size does not change when the current 
alphabet changes, but the the font and/or scaling is 
recalculated in order to obtain the best match. 


@® The unit cell and the display cell are always aligned at 
their upper-left corners. 


SET CELL UNIT SIZE 
e Normally when you change unit cell size, you would also make 
an analogous change to display cell size. 
e No drawing is done by the SET_CELL_UNIT_SIZE instruction. 
Device Notes: 


e Plotter GIDIS always sets unit cell size to display cell 
size. | 


e Plotter GIDIS always sets unit cell size exactly. 
Examples: 
BYTE 1.,45. ;Length=1, opcode for SET_CELL_UNIT_SIZE 


» WORD 10 5 -Width 
.WORD 30. >Height 


SET_COLOR_MAP_ ENTRY 


6.40 SET COLOR MAP ENTRY 


The SET_COLOR_MAP_ENTRY instruction sets the specified color map 
entry. All pixels that were previously drawn using that color 
map entry are immediately affected. 


Opcodes 16 Lengths: 6 
Formats SET _COLOR_MAP_ENTRY map, index, red, green, blue, mono 


map an integer representing a specific color map. 
For the Professional, this value must be 0. 


index an integer from 0 to (color map size -1), to 
identify the color map entry. 


red an integer in the range of 0 to 65935; 
representing the intensity of red. 


green an integer in the range of 0 to 65535, 
representing the intensity of green. 


blue an integer in the range of 0 to 65535, 
representing the intensity of blue. 


mono an integer in the range of 0 to 65535, 
representing the intensity of monochrome. 


Status: SUCCESS if map = 0 and index is in range; otherwise, 
FAILURE. 


Notes: 


e Table 6-7 shows color intensities in various formats: octal 
fraction, octal integer, unsigned decimal integer and signed 
decimal integer. Making an intensity value larger linearly 
increases intensity. For example, specifying 32768 sets a 
color to half its maximum intensity, while specifying 65535 
sets a color to its maximum intensity. 


SET COLOR _MAP_ENTRY 


Table 6-7: Sample Color Map Values 


Octal Octal Unsigned Signed 
Fraction Integer Decimal Decimal 
Integer Integer 
0.0 0 0 0 
ree 20000 8192 8192 
U2 40000 16384 16384 
0.3 60000 24576 24576 
0.4 100000 32768 -32768 
0.5 120000 40960 -24576 
0.6 140000 49152 -16384 
0.7 160000 57344 -8192 
Max LITT] 65535 -1 


Device Notes: 


Video GIDIS ignores this instruction unless the system has an 
Extended Bitmap Option (EBO). 


On a Video with an EBO, there are 8 color map entries. On 
Palette, there are 16 color map entries. 


On Professional 350 Video, there are 8 intensity levels 
available for mono, red, and green; and 4 for blue. 


On Professional 380 Video and Palette, there are 16 intensity 
levels available for mono, red, green, and blue. 


SET_COLOR_MAP_ENTRY 


e If any in-between value is specified, the next lower value is 
used. However, how "in between" values are treated is device 
specific. For example, the PRO 380 treats 0.16 (octal) for 
red as 0.15, while the PRO 350 treats 0.16 (octal) as Q.1. 


@e Sixel GIDIS and Plotter GIDIS ignore this instruction. 


Example: 


-BYTE 6.,16. ;length=6,opcode for SET_COLOR_MAP_ENTRY 

- WORD J. ;PRO’s bitmap (value must be 0Q) 

. WORD i Color index 1 

. WORD AQT D2 ;Red is three-quarters 

- WORD 40960. ;Green is five-eighths 

- WORD 0 *Blue is zero 

. WORD 32768. ;Monochrome is one-half 
;This makes dark yellow on a color 
;system. 
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6.41 SET_GIDIS OUTPUT SPACE 


SET_GIDIS_OUTPUT_SPACE specifies the coordinate units and_ shape 
of a window you define in GOS. Simultaneously, it sets the 
output clipping rectangle to coincide with the window. This 
instruction also resets GIDIS attributes as shown in Table 6-8. 


Opcodes: 9 Length: 4 


Format: SET_GIDIS_OUTPUT_SPACE ulx, uly, width, height 


ulx Is the x value to assign to the leftmost point 
in your window. 


uly Is the y value to assign to the topmost point in 
your window. In other words, [ulx, uly] is the 
Origin of the window. 


width specifies the number of x units in your window 
(See second note below. ) 


height Specifies the number of y units in your window 
(See second note below.) , 


Statuss SUCCESS if width and height are greater than zero; 
otherwise, FAILURE. 


Notes: 


@ When drawing a picture with GIDIS, you normally just use a 
SET_OUTPUT_IDS instruction. This sets your viewport and 
clipping rectangle to the entire view surface, and makes GOS 
units and IDS units the same. For example, if the view 
surface width in IDS is 960, then the view surface width in 
GOS is also 960. You only need to use SET_GIDIS_OUTPUT_SPACE 
if you do not want to draw on the entire view surface or if 
you want to draw only a portion of a picture on the view 
surface. (See the third note.) 


e If the window shape is not the same as the viewport shape, 
then space is left unused to the right or bottom of the 
picture. Figure 6-7 shows how a window with an extent of 
1000 x 1000 maps to a viewport with an extent of 1500 x 1000. 
Note how GIDIS begins at the upper left-hand corner and fills 
as much of the viewport as possible. In this case the 
vertical extents match, so the picture extends to the bottom 
of the viewport. Since the horizontal extents do not match, 
GIDIS leaves space on the right. 
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Figure 6-7: Mapping of GOS to a Different Shaped Viewport 


The SET_GIDIS_OUTPUT_SPACE instruction makes it easy to 
display a selected rectangle from a larger picture. Choose 
the portion of the picture you want. Use its origin, width, 
and height as arguments to SET_GIDIS_OUTPUT_SPACE, and then 
draw the whole picture. GIDIS will fill your viewport with 
the desired picture section and clip away the rest. The 
effect is that of enlarging a portion of your picture, while 
maintaining all existing proportions. (However, if the GIDIS 
instructions that comprise the whole picture include a 
SET_OUTPUT_GOS or SET_OUTPUT_IDS, you will not achieve the 
desired result.) Figure 6-8 shows how a selected portion of a 
GIDIS picture maps to a viewport with an extent in IDS of 500 
x 500. The area to be drawn is identified by the following 
arguments: 


ulx = 300 
uly = 100 
width = 100 
height = 100 
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Figure 6-8: Mapping a Portion of a Picture to a Viewport 


It 18 recommended that ulx, uly, (ulx + width), and 

(uly + height) never be set larger than 16384 (2 to the 14th 
power). This will allow sufficient off-screen address space 
for accurate clipping. 


No drawing is done by the SET_GIDIS_OUTPUT_SPACE instruction. 


Table 6-8 lists all of the GIDIS attributes modified by the 
SET _GIDIS_OUTPUT_SPACE instruction. Standard text size is 
the number of GOS units needed to match hardware character 
Size to the size set by INITIALIZE -1. 


SET_GIDIS_OUTPUT_SPACE 


Table 6-8: GIDIS Attributes Affected by SET_GIDIS OUTPUT SPACE 


Attribute Value 

GIDIS output space as specified 
clipping region same as GOS 
current position x 0 

current position y 0 

line texture size N/A 

area texture width 12 

area texture height 25 


logical pixel x offset 0 
logical pixel y offset 0 
logical pixel width 0 
logical pixel height 0 


cell movement mode flag 2% (Implicit) 
cell explicit movement dx 0 

cell explicit movement dy 0 

cell display size width 12 

cell display size height Zo 

cell unit size width 12 

cell unit size height 29 

Example: 


sassume Video GIDIS 

BYTE Pear Oe age ;length=2,opcode for SET_OUTPUT_IDS 

. WORD 960. swidth 

. WORD 600. sheight (upper left corner is [0,0] and 
; dower fight. corner 1s.[959;599)) 


JBY re ree ee ;length=4,opcode for SET_OUTPUT_VIEWPORT 
- WORD QO. ; 

- WORD Oh ;Sets the viewport to the left half 

. WORD 480. ; of the screen 

. WORD 600. ; 


SET_GIDIS_OUTPUT_SPACE 


BYTE 4.,9. ;length=4,opcode SET_GIDIS_OUTPUT_SPACE 
. WORD Ou -Sets GOS to 0 to 2399 in X 

.WORD 0 > and 0 to 2999 in Y (all within the 
- WORD 24004 > left half of the screen). 

. WORD 30002 Because 480/600 = 2400/3000, there is 


; no wasted space at the bottom or 
; right of the viewport. 


SET_LINE_TEXTURE 


6.42 SET LINE TEXTURE 


SET_LINE_TEXTURE defines the line texture, a bit pattern that is 
scaled and repeated in drawing straight lines and arcs. 


Opcode: 17 Length: 3 
Formats SET_LINE_TEXTURE patlen, pattern, size 


patlen Is the length (in bits) of the specified 
pattern. It must be in the range 1 to 16. 


pattern Is the bit pattern to use. PRO/GIDIS begins the 
pattern by using the low-order (rightmost) bit 
(bit 0) first. 


size Specifies the length of pattern repetition in 
GOS units. It must be greater than zero. 


Status: SUCCESS if patlen is in the range 1 to 16, and if size 
1s greater than 0; otherwise, FAILURE. 


Notes: 


e The size argument in this instruction is handled much like 
size in the SET_CELL_UNIT_SIZE instruction. However, scaling 
is limited to integral multiples of the pattern. 


@e Drawing with a solid pattern (that is, pattern = -1) 18S quite 
a bit more efficient than drawing with a nonsolid pattern. 


@® When specifying a nonsolid pattern, a highly multiplied 
pattern is best. For example, patlen = 2 and pattern = 1 are 
more efficient than patlen = 16 and pattern = 255 for drawing 
a dashed line. | 


@® Pixel size does not change how often the pattern repeats, 
although the appearance of the line does change somewhat. 


e The pattern is rotated as lines are drawn, so that the 
pattern is preserved around corners and bends. 


e Conversely, the only way to force the pattern to bit 0 is to 
issue another SET _LINE_TEXTURE instruction. 


e Except for Plotter GIDIS, the size given is used only for 
horizontal and vertical lines. Diagonal lines have a size 
that is larger by as much as a factor of the square root of 2 
ere: 3k es 


SET_LINE_TEXTURE 


No drawing is done by the SET_LINE_TEXTURE instruction. 


Device Notes: 


e For Plotter GIDIS, the specified pattern is mapped to the 
closest pattern provided by the plotter hardware. The 
patterns provided are solid, dashes, long dashes, long dash 
short dash, long short short, and dots. The size of the line 
pattern is set to the value specified in the command, with a 
minimum of about .125 inches. The pattern is rotated rather 
than projected when a diagonal line is drawn. 

@e Plotter GIDIS maintains the correct size regardless of the 
direction of the lines. 

Example: 


sBYTE ears Oy ;length=3., opcode for SET_LINE_TEXTURE 

. WORD 8. ;patlen 

- WORD *B10001111 ;ON, ON, ON, ON, OFF, OFF, OFF, ON 
;Bits are used in order low to high 

. WORD 100: ;Size of one repetition of pattern in 
;GIDIS output space 
;smakes subsequent lines dashed 
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6.43 SET OUTPUT BITMAP 


SET_OUTPUT_BITMAP tells GIDIS which page of the 380 video bitmap 
to make current. All drawing executes on the current bitmap. 


Opcode: 145 Length: 2 
Formats: SET_OUTPUT_BITMAP bitmap-no, dis-flag 
bitmap-no Specifies which bitmap to make current. In low 
resolution mode, the value can be 1 to 4. In 
high resolution mode, the value can be 1 to 2. 
dis-flag Controls whether the current bitmap is to _ be 
displayed. If flag is set, the current bitmap 
is displayed. If flag is not set, the current 
bitmap is not displayed. 
Status: SUCCESS 
Notes: 


® Each bitmap is a complete environment with its own color map. 


® SET_OUTPUT_BITMAP does not alter any other GIDIS attributes. 
It only affects the current bitmap. 


@ Do a SET_OUTPUT_BITMAP with a dis-flag of 0, if you want to 
continue looking at the current picture on the screen while 
GIDIS draws the next picture. This is a useful feature ina 
slide show application, for instance. 


@® SET _OUTPUT_BITMAP is available on the Professional 380 only. 


Device Notess: 


® You may scroll the displayed bitmap, provided you do not 
write to that bitmap while it is not the displayed bitmap. 


@ Always go back to bitmap 1 before using text mode. You can 
do this in several ways: 


e Use SET_OUTPUT_BITMAP with a bitmap-no argument of 1 
® Use the DCL command CLEAR 


e® Use a RIS €sCape -sequence 
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6.44 SET_OUTPUT_CLIPPING REGION 


SET_OUTPUT_CLIPPING_ REGION Specifies the output clipping 
rectangle. The clipping rectangle is the area on the view 
surface where PRO/GIDIS can draw. 


Opcode: 4 Length: 4 
Format: SET_OUTPUT_CLIPPING_REGION ulx, uly, dx, dy 


ulx Specifies the x coordinate of the left edge of 
the clipping region. 


uly Specifies the y coordinate of the top edge of 
the clipping region. 


dx sets the rightmost x of the clipping rectangle 
to ulx + dx. 


dy Specifies the bottommost y of the clipping 
rectangle to uly + dy. 


Status: SUCCESS if width and height are not negative; otherwise, 
FAILURE. 


Notess 


@® You cannot set the clipping region to an area larger than the 
device’s Hardware Address Space (HAS). An attempt to do so 
reduces the clipping region to the available space. 


e Clipping does not affect the setting of the current position. 
For example, if you draw a line that ends outside the 
clipping rectangle, the current position is set to the x and 
y you specified, even though only part of the line was drawn. 


@ Clipping applies to all drawing. For example, any part of a 
character outside of the clipping region is not drawn. 


e Clipping does not affect drawing accuracy. In particular, if 
only part of an arc is inside the clipping region, that part 
is drawn correctly. 


SET_OUTPUT_CLIPPING_REGION 


@e Because the clipping rectangle includes the right and bottom 
borders, 


SET_POSITION 100, 150 
DRAW_LINES 500, 150 


draws pixels from [100,150] to [400,150] inclusive. Note 
that the current position is now [500,150]. 


@e No drawing is done by the SET_OUTPUT_CLIPPING_REGION 


instruction. 
Example: 
.BYTE 4.,4. ;length=4, 
;opcode for SET_OUTPUT_CLIPPING_REGION 
. WORD 100. ;Sets output clipping region to rectangle 
. WORD 100. ;with the upper left corner at 100,100 
- WORD 400. ;and the lower right corner at 500,200. 
- WORD 100. 
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6.45 SET OUTPUT CURSOR 


SET_OUTPUT_CURSOR selects the symbol to be used as the cursor and 
aligns it relative to the current position. The cursor is a 
visible indication of the current position. 


Opcodes: 5 Lengths: 6 


Format: SET_OUTPUT_CURSOR alphabet, index, width, height, 
offset-x, offset-y 


alphabet Specifies the alphabet containing the character 
or the special cursor alphabet (-1). 

index Specifies the character or special cursor. 

width Specifies the width of the cursor. The width 
must be greater than or equal to zero. 

height Specifies the height of the cursor. The height 
must be greater than or equal to zero. 

offset-x Specifies distance from the left edge of the 
cursor to the current position (range is 0 to 
width). 3 

offset-y Specifies distance from the top edge of the 
cursor to the current position (range is 0 to 
height). 


Status: SUCCESS if alphabet is -1 to 15, alphabet width is less 
than or equal to 16, alphabet height is less than or 
equal to 16, and the offsets are in range; otherwise, 
FAILURE. 


Notes: 
e Applies to Video GIDIS only. 


e If the alphabet is not -1, the width and height are treated 
as a unit cell size; there is no equivalent of a display 
cell. When the specified character is scaled to width and 
height (using the rules described under 
SET AREA_TEXTURE_SIZE, the x and y offsets are scaled by the 
same ratios. 


SET_OUTPUT_CURSOR 


@ An alphabet code of -1 specifies that one of the following 
special built-in cursors should be used: 


No cursor 

Implementation default (Same as 1) 

Tracking cross (small cross) 

Crosshairs (full clipping rectangle width and height) 
Block (solid rectangle) 

All other values are reserved. 
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Width, height, and the offsets are ignored when the tracking 
cross or crosshairs are used. 


e If the chosen cursor is neither a special cursor nor a 
character in alphabet 0, your program must define the 
character before executing SET_OUTPUT_CURSOR. Redefining the 
selected character after a SET_OUTPUT_CURSOR does not change 
the cursor’s appearance. You must use another 
SET_OUTPUT_CURSOR to change the appearance of the cursor. 


@ When the SET _OUTPUT_CURSOR instruction executes, the 
appearance of the cursor changes immediately. 


Device Notes: 


® SET_OUTPUT_CURSOR changes only the GIDIS cursor. However, 
turning the Terminal Subsystem’s text cursor ON or OFF has 
the side effect of turning the Video GIDIS cursor ON or OFF. 


Example: 

.-BYTE Orgies 4 ;length=6,opcode for SET_OUTPUT_CURSOR 

. WORD oe sAlphabet 1 (user-defined alphabet) 

.WORD 2. Character index value 
>(Assume that Alphabet 1, character-index 
72, is defined as an arrow pointing 
;straight upward 

- WORD 30. -Width of 30 

- WORD 505 ;Height of 30 

. WORD (eow -offset-x 

. WORD 0% ;offset-y 


*>Makes the arrow the new cursor and 
pallgns 1c such Chat. its. Lip: a¢6 ac. the 
SCUPTENT -DOS1 E10n:. 


Example: 


2BYik 
-WORD 
-WORD 
-WORD 
-WORD 
- WORD 
-WORD 


SET_OUTPUT_CURSOR 


;length=6,opcode for SET_OUTPUT_CURSOR 
;PRO/GIDIS Cursor Alphabet 

;No cursor 

sWidth value of zero (ignored) 
;Height value of zero (ignored) 
;offset-x (ignored) 

;offset-y (ignored) 

turns the GIDIS cursor off 
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6.46 SET OUTPUT CURSOR_RENDITION 


SET_OUTPUT_CURSOR_RENDITION controls cursor and rubber band 
rendition. The rendition options are blinking and continuous. 


Opcode: 72 Length: 1 
Formats: SET _OUTPUT_CURSOR_RENDITION mask 
mask Is a word that specifies the rendition. The 
rendition is represented in the mask as a bit. 
If the 0 bit is set, the cursor or rubber’ band 
blinks; if not, it is continuous. 
Status: SUCCESS 
Notes: 
@e Applies to Video GIDIS only. 


e Bits 1-15 of mask are reserved. 


@e Using a continuous cursor during picture drawing is very 
expensive. 


Example: 
sBYTE 1.,72. j;length=1, opcode for 


SET _OUTPUT_CURSOR_RENDITION 
. WORD 0. sset to continuous mode 
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6.47 SET_OUTPUT_IDS 


SET_OUTPUT_IDS specifies the width and height of Imposed Device 
Space (IDS). It also sets GIDIS Output Space, the clipping 
rectangle, and the viewport to be identical with IDS, and _ sets 
all GIDIS attributes as shown in Table 6-9. 


Opcode: 12 Lengths: 2 

Formats SET_OUTPUT_IDS width, height 
width Specifies the number of x units on your device 
height Specifies the number of y units on your device 


Status: SUCCESS if width and height are greater’ than 0; 
otherwise, FAILURE. 


Notes: 


@e The upper left corner of IDS is always [0,0]. The 
coordinates of the lower-right corner are [width -1, height 
-1). 


@ When the shape of IDS is not equal to the shape of the 
hardware address space, only the top left portion of the view 
surface is used. This mapping mirrors the mapping of GOS to 
a different shaped viewport. See note 2 under 
SET _GIDIS_OUTPUT_SPACE. 


e It is recommended that width and height never be set larger 
than 16384 (2 to the 14th power). This will allow sufficient 
off-screen address space for accurate clipping. 


@ No drawing is done by the SET_OUTPUT_IDS instruction. 


® Table 6-9 lists all of the GIDIS attributes affected by the 
SET _OUTPUT_IDS instruction. 


SET_OUTPUT_IDS 


Table 6-9: GIDIS Attributes Affected by SET OUTPUT_IDS 


Attribute | Value 

IDS width as specified 
IDS height as specified 
viewport same as IDS 
GIDIS output space same as IDS 
clipping region same as IDS 
current position x 0 

current position y 0 

line texture size N/A 

area texture width de 

area texture height 25 


logical pixel x offset 0 
logical pixel y offset 0 
logical pixel width 0 
logical pixel height ) 


cell movement mode flag 2. (implicit) 
cell explicit movement dx 0 

cell explicit movement dy 0 

cell display size width 12 

cell display size height Ean) 

cell unit size width : i 

cell unit size height 25 


Examples: 


BYTE 
- WORD 
- WORD 


2BxY LE 
-WORD 
- WORD 
- WORD 
- WORD 


s<BYTE 
- WORD 
- WORD 
- WORD 
- WORD 


SET OUTPUT _IDS 


assume Video GIDIS 

;length=2,opcode for SET_OUTPUT_IDS 
swidth 

;height (upper left corner is [0,0] and 
; lower right corner is [959,599]) 


;length=4,opcode for SET_OUTPUT_VIEWPORT 


;Sets the viewport to the left half 
: of the screen 


;length=4,opcode SET_GIDIS_OUTPUT_SPACE 


;Sets GOS to 0-to-2399 in X 

> and 0-to-2999 in Y (all within the 
: left half of the screen) 
-Because 480/600 = 2400/3000, there is 
;no wasted space at the bottom and 
;right of the viewport. 


SET_OUTPUT_RUBBER_BAND 


6.48 SET OUTPUT RUBBER BAND 


SET_OUTPUT_RUBBER_BAND specifies if a rubber band is to be 
generated. It also gives the origin of the rubber band. 


Opcode: 53 Length: 3 


Format: SET_OUTPUT_RUBBER_BAND type, origin-x, origin-y 


type Is the type of rubber band to use. (See table 
6-10.) 

origin-x Is the x coordinate of the desired rubber band’s 
Origin. 

origin-y Is the y coordinate of the desired rubber band’s 
OFf1gin:: 


Status: SUCCESS if the type is legal; otherwise, FAILURE. 


Table 6-10: Types of Rubber Bands 


Type Code Rubber Band 
-1 No rubber band 
0) Default (same as -1) 
1 Rubber band line 
2 Rubber band rectangle 
Notes: 


@ Applies to Video GIDIS only. 


@e The SET_OUTPUT_CURSOR_RENDITION instruction applies to rubber 
bands as well as cursors. 


SET_OUTPUT_RUBBER_BAND 


@® The rubber band line is drawn from its origin to the current 
position. . 


@e The rubber band rectangle is a rectangle with one corner at 
the rubber band origin and the opposite corner at the current 
position. The rectangle will degenerate to a line (or point) 
if one or both of the coordinates of the current position and 
rubber band origin are the same. 


e Since both the cursor and the rubber band are drawn in 
complement mode, it may be preferable to turn the cursor OFF 
when a rubber band is ON. 


Example: 


BYTE Seyoos ;length=3., opcode for 
*SET OUTPUT_RUBBER_BAND 

- WORD ee srubber band line 

. WORD 50. ;its origin is [50,60] 

-WORD 60. 


-BYTE 2.,29. ;length=1., opcode for SET_POSITION 
. WORD 100 ;new current position | 
. WORD 300. sis [100,300] 


there will be a rubber band line from 
*{50,60]) to [100,300]. 
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6.49 SET OUTPUT VIEWPORT 


SET_OUTPUT_VIEWPORT specifies the size and location of your 
viewport. Your viewport is the rectangle on the view surface to 
which your picture is mapped for display. SET_OUTPUT_VIEWPORT 
also sets the clipping rectangle to match the viewport. 


Opcode: 13 Length: 4 
Formats SET_OUTPUT_VIEWPORT ulx, uly, width, height 


ulx specifies the x coordinate of the left edge of 
the viewport, in IDS units 


uly Specifies the y coordinate of the top edge of 
the viewport, in IDS units 

width Specifies the width of the viewport, in IDS 
units 

height specifies the height of the viewport, in IDS 
units 


Status: SUCCESS if width and height are greater’ than 0 
otherwise, FAILURE. 


Notes: 


e Use this instruction when you want the drawing area to be 
smaller than the view surface. 


@e To copy a picture to another part of the view surface and/or 
change its size, you need only do a SET_OUTPUT_VIEWPORT and 
then redraw the picture. You need to do a 
SET_GIDIS_OUTPUT_SPACE as well only if you want to draw a 
different portion of the picture. 


@e Unlike SET_OUTPUT_IDS and SET_GIDIS_OUTPUT_SPACE, this 
instruction does not initialize any of the GIDIS attributes. 
However, it does alter them. For example, suppose cell unit 
width in GOS is 36 and you make your viewport half as wide. 
This makes every GOS unit half as wide. Thus if cell unit 
width had been 18 pixels, it is now 9 pixels. Cell unit 
width in GOS is still 36, but 36 GOS units is half as wide as 
before. 
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@ A SET_OUTPUT_IDS simulates a SET _OUTPUT_VIEWPORT with 
arguments as follows: 


ulx = (0 
uly = 0 
width = width of IDS 


height height of IDS 
e No drawing is done by the SET_OUTPUT_VIEWPORT instruction. 


Example: See SET_GIDIS_OUTPUT_SPACE description. 
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6.50 SET PIXEL SIZE 


SET_PIXEL_ SIZE permits you to set the size of the logical pixel 


used fo 


r drawing straight lines and arcs. For large pixels, you 


also control where the pixel is aligned relative to the current 
position. 


Opcodes: 
Format: 


width 


height 


offset 


offset 


Status: 


Notes: 


e The 
and 


19 Length: 4 
SET_PIXEL_SIZE width, height, offset-x, offset-y 


Specifies the width of the logical drawing 


pixel. 
Specifies the height of the logical drawing 
pixel. 

~X Specifies distance from the left edge of the 


pixel to the current position. 


-y Specifies distance from the top edge of the 
pixel to the current position. 


SUCCESS if width and height are greater than or equal to 
zero, offset-x is greater than or equal to zero and not 
greater than width, and offset-y is greater than or 
equal to zero and not greater than height; otherwise, 
FAILURE. 


drawing pixel is always a rectangle orthogonal to the X 
Y axes. 


@e Changing pixel size does not change the size of GOS units. 


It 3 


ust tell GIDIS the size and alignment of the rectangle to 


draw at each point along the line. Thus patterned lines have 
less "off space" when pixel size is large. 


@e Default pixel size is device dependent. It is between 1/50 


and 1/100 of an inch. If possible, one hardware pixel is 
used. 

@ A size value that maps to a size smaller than a hardware 
pixel is set to the hardware pixel size. However, width = 0 


and 


height = 0 sets the logical drawing pixel to the default 


pixel size. 
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SET PIXEL SIZE 
@e Because the pixel is a rectangle, a diagonal line is thicker 
than a horizontal or vertical line. 


@e When pixel size is not 1 x 1, complement writing mode can 
produce unexpected results. 


e No drawing is done when the SET_PIXEL_SIZE function executes. 
Device Notes: 


@e On Plotter GIDIS, SET_PIXEL_SIZE sets line width to (width + 
height) /2. 


@® On Plotter GIDIS, one hardware pixel is the size of the pen. 


@e For purposes of drawing thick lines on a plotter, a hardware 
pixel is treated as 1/75 of an inch. However a double line 
is not drawn until line width is greater than 1/30 of an 
inch. This is to accommodate the fact that a ./mm pen is 
almost this thick. | 


Examples 
.BYTE 42,19. ;length=4,opcode for SET_PIXEL_SIZE 
.WORD 6. ;width in GIDIS output space units 
. WORD 6. ;Height in GIDIS output space units 
. WORD 3 -Centers the current position 
;horizontally 
. WORD cz ;Centers the current position vertically 
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6.51 SET PLANE MASK 


SET_PLANE_MASK performs a Boolean AND operation on the plane-mask 
and the current color index and sets pixels using the resultant 
index. For example, if the current color index is 5 and the 
plane-mask is 3, a color index 1 (=3 AND 5) is actually used. 


Opcodes 20 Lengths: 1 


Format: SET PLANE MASK plane-mask 


plane-mask Is a bit mask representing a combination of 
planes. A set bit indicates an accessible 
plane. 


Status: SUCCESS 
Notes: 
® Use a mask of -1 to ensure that all planes are accessible. 
@ No drawing is done by the SET_PLANE_MASK instruction. 
Device Notes: 

@® When used with an EBO, the text portion of the Terminal 
Subsystem uses plane 3 for text. When not used with an EBO, 
it uses plane 1 for text. 

e The various GIDIS devices have different numbers of planes: 

- Professional Video with the EBO has 3 planes. 
- Palette has 4 planes. 

- Plotter GIDIS has 3 planes. 

- All other devices have 1 plane. 

@® In Video GIDIS the color map can be used in combination with 
the plane mask to prepare separate images in separate planes 
for switching back and forth quickly. For example: 

;Sset all color map entries to dark 
jand clear bitmap 


.BYTE Ogata Oe ;length=1,opcode for SET PLANE MASK 
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SET PLANE MASK 


. WORD La ;plane 1 
;draw image A in plane 1 
;Set color map entry 1 to desired color 
;Image A appears 

-BYTE 1.,20. ;length=1,opcode for SET_PLANE MASK 

. WORD Ze ;plane 2 


;draw image B in plane 2 


;Set color map entry 1 to dark 
;Image A disappears 


;set color map entry 2 to desired color 
;image B appears 


However long it took to draw Image B, it will appear all at 
once. You can continue flipping images A and B very quickly. 
In other words, you can draw B while A is being viewed and so 
Loren. 


Example: 
BYTE Disa Os ;length=1,opcode for SET_PLANE_MASK 


. WORD “BOs ;Enables GIDIS access to planes 1 and 2 
;Plane 3 is write-protected 
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6.52 SET POSITION 


SET_POSITION sets the new current position to the specified 
coordinates. 


Opcode: 29 Lengths 2 
Format: SET _POSITION x, y 


x Specifies the new x coordinate of the current 
position. 


4 Specifies the new y coordinate of the current 
position. 


Status: SUCCESS 


Notes: 


e Current position may be set outside the clipping region. 
However, x and y should never be set larger than 16384 (2 to 
the 14th power). This will allow sufficient off-screen 
address space for accurate clipping. 


e No drawing is done by the SET_POSITION instruction. 
Examples 


-BYTE 2.,29. ;Length=2, opcode for SET_POSITION 
. WORD 100. ;New current position 
. WORD 350 ;is [100,350] 
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6.53 SET PRIMARY_COLOR 


SET_PRIMARY_COLOR sets the primary color index to use in drawing 
subsequent objects. Primary color is the color used for ON bits 
in current line texture, current area texture, and character 


glyphs. 

Opcodes: 21 Length: 1 

Formats: SET PRIMARY COLOR color-value 

color-value Specifies primary color as an index. On a 

multi-plane system, color-value functions as an 
index into the color map. On a single-plane 
system it specifies ON (color-value not 0) or 
OFF (color-value 0). 

Status: SUCCESS 


Notes: 


e Refer to the INITIALIZE instruction for a list of the 
power-on default colors. 


e If color-value is greater than color map size, color-value 
modulus map size is used. 


e This instruction is affected by the SET_PLANE_MASK 
instruction. 


@ No drawing is done by the SET_PRIMARY_COLOR instruction. 
Device Notes 


e See Appendix E for the relationship between color and pens in 
Plotter GIDIS. 


Example: 


-BYTE fares ae slength=1,opcode for SET_PRIMARY_COLOR 
. WORD 4, -defines primary color as color number 4 


6-107 


SET_REL POSITION 


6.54 SET REL POSITION 


SET_REL_ POSITION sets a new current position as an offset from 
the old current position. 


Opcodes 30 Length: 2 


Format: SET_REL POSITION dx, dy 


Specifies the x coordinate of the new current 
position as: x of current position + dx. 


Specifies the y coordinate of the new current 
position as: y of current position + dy. 


Statuss SUCCESS. 


Notes s 
@e SET_REL_ POSITION [dx,dy] is always the same as SET POSITION 
{Current x + dx, Current y + dy]. 
® Current position may be set outside the clipping region. 
However, x and y should never be set larger than 16384 (2 to 
the 14th power). This will allow sufficient off-screen 
address space for accurate clipping. 
e No drawing is done by the SET_POSITION instruction. 
Examples 


;Current position is [100,350] 


BYTE Lee SON ;Length=2, opcode for SET_REL_ POSITION 
. WORD TOs ;Relative position is 
.WORD -50. °{+100,-50] 


;New current position is [200,300] 
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SET_SECONDARY_COLOR 


6.55 SET_SECONDARY COLOR 


SET_SECONDARY_COLOR sets the secondary color, for use in drawing 


subsequent objects. secondary color is the color used for OFF 
bits in the current line texture, current area texture, and 
glyphs. It is also the color generated by NEW_PICTURE and 
ERASE_CLIPPING_REGION, and scrolled in by SCROLL_CLIPPING_REGION. 
Opcode: 15 Length: i 

Formats SET SECONDARY COLOR color-value 


color-value an index. On a 


color-value functions as an 


Specifies secondary color as 
multi-plane system, 


index i1nto the color ‘map. On a single-plane 
system, it specifies ON (color-value not 0) or 
OFF (color-value 0). 

Status: SUCCESS 

Notes: 


@e Refer to the SET_COLOR_MAP_ENTRY description for a list of 
the power-on default colors. 


e If color-value is greater than color map size, color-value 
modulus map size is used. 


@® SET_SECONDARY_COLOR is affected by the SET_PLANE_ MASK 
Instruction: 


e This instruction does not draw anything or affect the view 
surface. 


Device Notes 
@e See Appendix E for the relationship between colors and pens. 


e Plotter GIDIS never changes the secondary color: the paper 


always remains the same color. 


If you set secondary color to 
with the pen that is normally 


e If secondary color modulus 16 
Plotter GIDIS slows pen speed 


However there is an effect. 
N, drawing in color 0 will draw 
used when drawing with color N. 


is greater than or equal to 8, 
to 10 cps. The slower speed 


results in better quality when drawing a transparency. 
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SET_SECONDARY_COLOR 


Example: 


.BYTE 1.,15. ;length=1,opcode for SET_SECONDARY_COLOR 
- WORD 5 ee ;defines secondary color as index 1 
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SET_WRITING_MODE 


6.56 SET WRITING _MODE 


SET_WRITING_MODE defines how PRO/GIDIS interprets ON and OFF bits 
in line textures, area textures, and glyphs. There are 10 
options as described in Table 6-11. 

Opcode: 22 Length: 1 

Format: SET_WRITING_MODE mode-code 


mode-code Specifies one of the integer values listed in 
Table 6-11. 


Table 6-11: Writing Mode Options 


Code Writing Mode Description 


0 Transparent Updates the current position, but 
does no drawing. 


1 Transparent Updates the current position, but 
Negate does no drawing. 
Z Complement If current-pattern-bit is on, 


complements the color of the 
current pixel. This means the 
Current pixel is set to (2 ** 
Diane's. Current color). In’ a 3 
plane system, complementing 2 sets 
1 “tO 6 C2 Ae oS 2) 


3 Complement Negate If current-pattern-bit is off, 
complements the current pixel. 


4 Overlay If current-pattern-bit is on, the 
current pixel is set to the 
current primary color. 


2) Overlay Negate Tf -current-pattern=bit 1S:0ff, the 
current pixel is set to the 
current primary color. 


i 
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SET WRITING MODE 
ee a a ae ee ee 


Code Writing Mode Description 
sei ee eet ee ee 
6 Replace If current-pattern-bit is on, the 


current pixel is set to the 
current primary color (Same as 
overlay). If current-pattern-bit 
is off, the current pixel is set 
to secondary color. 


7 Replace Negate If current-pattern-bit is off, the 
current is set to the current 
premary color. LE 
current-pattern-bit is on, the 
current pixel is set to secondary 
COLT, 


8 Erase The current pixel is set to 
secondary color. 


9 Erase Negate The current pixel is set to 
primary ‘color. 


Status: SUCCESS if a valid mode is requested; otherwise, 
FAILURE. 


Notes: 


@e No drawing is done by the SET_WRITING_MODE instruction. 


Figure 6-9 shows the same line texture (which includes ON and OFF 
bits) drawn over light and dark areas in all visible writing 


modes. 
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SET WRITING MODE 


eee CAV SOD OE E09 660 08 08 8 88 CSTE CATE TOPS SHC E DOOD ERO 408 e888 
| a eat™ —f Pp S Ee TT -: Ss0,G tb tc0 Oct UU Grace AB OCA OE Tare oCacaraOtarece ad otatata a oterucateraretettitatetatate 


$69 006666 45 
PHEVEVEAEDOCTESCUORECOC OCS ORD ECC CRDHRO RN SDE ODS 0668068 6 8 8°6 
| a eal} =P er ear} 5 Neg at. aw gehen a ata ta tatitatataletatanatetatatatatatetetelatatelatatatatetatel O06 00006 ee tne st 


3, etete” aa st Aged tf Ry ate PPR] ete’ ate BA etetst A Pid a utee Fd Bg ‘atat tet ete’ PR ‘ate’, Py ata’ Ad BA ats! 


SBRRRRSS we spannnons ag pee atatatatatetatatafatatatatctatatat batch tatetatatatastatatstatctstatetststetcectcecerartrerererorevereveuavecarecesavers 
$.5.6.8 0-49 He siete seer eeeessea OF CU CSTE CK RES CRRA AE RETOOL E OREO A ae 

EEG E08 TERS ORDA ECE SOONG CRG H RUE ORDERED EAU ES COU eee he 8 8 4 8 

CO WV €& i ] es tf N G= 4 2 E& Pee bee ee ee seat bea cae teite ate stats ere drastarestatetnte lates bteteatetents 


Oe . 
40009 40.6 68 60 c'0 6.0 1-68 08 § bss 004 60.0 006060 8685.4 bee Eee es 08'S 
BRS Bas SRR Be RRR esPatatatatctatatatatatetetalahetgitea drtitcecsrera.erece erveoeaterdve ce evecererevavararucncers'al "¢ 


$9.4 284 09 6 8 8 Oe te 288 G8 Oe tne be 8 86 66 8b 8 88 88 ke 6 8 66 88 8 ee 8 6 8 
f g = 1 ate tases eases ere, 0 0000050008 010, O19,0,oneuesececeveceldlearécelecorevere.ocnserevolececerarscguarive 
ote se 
qa Ch 
eratetere serene 
PEO CCE PERO ERUER SEC CO GROSUGO ECAC REEDS CHRO Oh ee et 
R e f 1 ace WN e r—4 t, & vaiatetececacetsrevarateva acerele srase"aravastaceton’s ech erars'arararsverstetevatcrerstucaters's'ats" 
ane 4 as LAS 148 
CHO ACH NE WCW Wn I DC RL is TO CY 
24.64:64:8 6 04 8 ate BP i a) 2.06.8 6 66 ¢ 6.6. 
vere oe) eee 
a ats ae 
> ee tt 
* hi a4 i4¢ af 


Wels a Pe ND eM I) oe Cw ore he i es. 
AAS AAAS S ea! ea ste btereteters Bed nit aetsvete t's'8 Be Rate 
vee nets oe as teens i sett Bee ie) veces es ae ahs 
' Ceneanes oe Pat saueuss cient 
cee vefe ne sete Hone’ save vate xt 
ie bd se’ wh ofate AS 
at ay 4s * ies o 6 2 +666 
Vas verse eee CES Os TRAN OC US 848 00 8 6') 0 6805 66 C888 O88 be 8 ae 6 rele 
rn lement. BRCAVIVUV RCo eee Cee kee eee nae ee 8 
se + Ves s 
Thieeun Gren ee 
KH GC OK SOME A 
; 08 88 
Ceseare¢eeuy ee 4 sects) Veeeeteye cheeses hte -8 8 8808. 
Cc Ch - 1 ‘2a { : I =) 4 f eM Cs eh ele ke cs ble ates ee eters etutateretath platetereretstatetatstetetatelutststetatatatatats! 
: a is neenees + . 
oe ? ieee pe ts ee 
Pp ig ‘ aretetatetatete Ae 
S29 8 Oe $2.8 & 200 688 8 8 9 * Oe. 


ide nt ee at eb ie Tatsteatselee eer setae teases 
Ee sie 4 Ss, & stwaee: tne ateteta le ee tetas et ovtte lenate arate 3 fala ee ie ee an atete sneta atetetatets 
ee Pee Da ae er eats ee a 
; ? a 
iat 
te) 


LUGS CVE ER EPO S TOURS TEEN ORO SPOOR EOTOCK reer re Can 


Ee Leeets : ‘ ‘ teeter 
er et — J N = - P—4 t ee Vat ee en enh a nb tre stern hrete he atelaterb a btavateretera stele eb ae ecate esau as 
Heatelatatuletatetstatetatatatatatatatatatatetctatatatatetstatatatatatalstatatatatatatelataletatatstatelel 
4 i a ‘ f a R OP CRH TOC CHHTRES CER EH OER OCOOHRERS ORO HOR ORGCO HED O OEE 4 O86 68 & 
4 O48 ea ae 4 i 2 : i x ; 
oeicn aistatateteCatetatateteletstetetatelstatatitatetatateteetatetatatatetatetetatetatetetatetatatetitetsigteratetseresacaverscucecareratecetgustarstert eran at tesa esececeseceescacacace cokracevererivere 
? : ; SCCCVG CCG RTE SHE RECO O SOR OOD DORO Cb e DCO ORO ase OO kee eh tee § 


Figure 6-9: Writing Modes Shown with Line Texture 


Device Notes 


® Plotter GIDIS treats modes 2, 3, 4, 5, 6, 7 as overlay and 
modes 0, 1, 8, 9 as transparent. 


Example: 


moe go eg ees 
- WORD 6. 


%@ @ 


length=1,opcode for SET_WRITING_MODE 
Specifies REPLACE writing mode 


a: 
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APPENDIX A 
PRO/GIDIS INSTRUCTION SUMMARIES 


This appendix contains PRO/GIDIS instruction summaries and report 
tags for quick reference. 


The instruction summaries are in two different formats: in 
ascending opcode order and in alphabetic order. The opcode and 
number of arguments are shown as separate byte values, and as 
opcode word values. The opcode word value = (opcode * 256) + 
number of arguments. Note, when the resultant opcode word value 
is greater than 32,000, it is subtracted from 65,536 (2**16) and 
a negative opcode word value results. 


Table A-1: GIDIS Instructions in Opcode Order 


Opcode Number of Opcode Instruction and Arguments 
Arguments Word 
0 0 0 NOP 
1 ab Vise | INITIALIZE mask 
3 2 770 SET AREA TEXTURE_SIZE w, h 
4 4 LOZS cE! OUTPUT CLIPPING REGION 


ul, Uly >. Wy 2 


5 6 L260 SET OUTPUT CURSOR 
alpha, index, w, h, ox, oy 


6 0 1536 NEW_PICTURE 


Opcode 


12 


a 


Lo 


20 


21 


22 


23 


24 


ZS 


26 


27 


28 


zg 


30 


31 


32 


33 


Number of 
Arguments 


4 


2N 


3N 


Opcode 
Word 


Oo ad 


5633 


58884+3N 


6144 


6400+2N 


66564+2N 


69124+3N 


7168 


7426 


1682 


T3936 


SL 9Z 


8448+N 


PRO/GIDIS INSTRUCTION SUMMARIES 


Instruction and Arguments 
SET _GIDIS _OUTPUT._SPACE 

My. “Oy. Wy. 1 

SET OUTPUT _IDS: wh 


bE TCOOUTPUT VIEWPORT 
IK, Wye ay hh 


SET AREA TEXTURE a, C 
SET SECONDARY COLOR color 


SET COLOR MAP ENTRY 
Me COLOr> fe O5--Dy Mone 


DHT LENE TEXTORE 
patlen, pattern, size 


SET PIMEG Si2ZE: wy. Ty Ox; OY 
SET PLANE MASK mask 

SET PRIMARY COLOR color 

SET WRITING_MODE mode 
DRAW_ARCS x, y, angle 

END PICTURE 

DRAW_LINES x, y 

DRAW _REL_LINES dx, dy 
DRAW_REL_ARCS dx, dy, angle 
FLUSH _BUFFER 

Sit -POSLELON oxy. -¥ 

SET REL POSITION dx, dy 
BEGIN _ FILLED _ FIGURE 

END. FPLILLED FIGURE 


BEGIN DEFINE CHARACTER 
Ce We. Gwe Tan | Potter.) 


Opcode 


34 


35 
36 
37 


a 


38 
40 


Al 


42 
43 
44 
45 


46 


48 


2 


a2 


54 
Se 
oe 
58 


65 


PRO/GIDIS INSTRUCTION SUMMARIES 


Number of 
Arguments 


2+N 


5: Or 6 


Opcode 


Word 


8706+N 


8960+N 


9216 


9474 


9472+N 


G29 


10242 


10498 


TU LoS 


11009 


Li265 


L322 


11775+N 


L2286 


13314 


ie eo ae 


13824 
14080 
14592 
14848 


16641 


Instruction and Arguments 


LOAD _CHARACTER_CELL 
Co: WH UO) as cs. dS 


DRAW_CHARACTERS char-index 
END DEFINE CHARACTER 
LOAD BY NAME name_0, name_1 


LOAD BY NAME 
Chi: Giz CaS |. 4. Cn 


SET_ALPHABET alphabet 
SET CELL DISPLAY SIZE w, h 


SET CELL EXPLICIT MOVEMENT ax, 
dy 


SET_CELL_MOVEMENT_MODE flags 
SET CELL RENDITION flags 

SET _CELL_ ROTATION angle 

SET CELL UNIT SIZE. w;. A 
CREATE ALPHABET 

w, h, extent, flags, 
[anitialize); Lave=width ] 
ERASE CLIPPING_REGION 


SCROLL CLIPPING _REGION 
Gx): ay 


SET OUTPUT _RUBBER_BAND 
type, xX, Y 


REQUEST_CELL_ STANDARD 
REQUEST_CURRENT_POSITION 
REQUEST _OUTPUT_SIZE 
REQUEST_STATUS 


SET _CELL_OBLIQUE angle 


PRO/GIDIS INSTRUCTION SUMMARIES 


Opcode Number of Opcode Instruction and Arguments 
Arguments Word 
69 Z 17666 SET_AREA CELL SIZE w, h 
v1 ) 18176 REQUEST _VERSION NUMBER 
TZ 1 18433 SET_OUTPUT_CURSOR_RENDITION 
- mask 
74 N 18944+N DRAW_PACKED_ CHARACTERS 
2charindex 
12S 0 -~32768 END_LIST 
141 6 OR 7 -29434 PRINT_SCREEN 


Xp Vy Wy, Dy Axly, dxly,. [mask] 


145 Z -28414 SET OUTPUT_BITMAP 
bitmap-no, dis-flag 


PRO/GIDIS INSTRUCTION SUMMARIES 


Table A-2 lists GIDIS instructions in alphabetical order. 


Table A-2: 


Opcode 


33 


“ed 


46 


23 


128 


37 


GIDIS Instructions in Alphabetical Order 


Number of 
Arguments 


4 or 5 


0 


4,5 or 6 


3N 


Opcode 
Word 


8448+N 


7936 


117754+N 


5888+3N 
8960+N 
6400+N 


18944+N 


6912+3N 
6656+N 
9216 
8192 
-32768 
6144 
12288 
7168 
25) 


9474 


Instruction and Arguments 


BEGIN_DEFINE CHARACTER 
c, w, nw,nh, [loff] 


BEGIN FILLED FIGURE 

CREATE ALPHABET 

w, h, extent, flags 
[initialize], [ave-width] 
DRAW_ARCS x, y, angle 
DRAW_CHARACTERS char-index 


DRAW_LINES x, y 


DRAW_PACKED CHARACTERS 
2charindex 


DRAW_REL_ARCS dx, dy, angle 
DRAW_REL_LINES dx, dy 
END_DEFINE CHARACTER 
END_FILLED_ CHARACTER 
END_LIST 

END PICTURE 

ERASE CLIPPING_REGION 

FLUSH BUFFER 

INITIALIZE mask 


LOAD BY NAME name_0, name_1 


PRO/GIDIS INSTRUCTION SUMMARIES 


Opcode Number of Opcode Instruction and Arguments 
Arguments Word 

37 3-7 9472+N LOAD _ BY NAME 
Ghisy sCh2y. (35. 23m 

34 2+N 8706+N LOAD_CHARACTER_CELL 
Ce. WIE, 2430s 

6 0 156 NEW_.PICTURE 

0 0 0 NOP 

1414 6 OR 7 -29434 PRINT_SCREEN 


Ky Ver We Dy Delyy dxly, TmasK] 


54 0 130.24 REQUEST. CELL STANDARD 
a 0 14080 REQUEST CURRENT -POSTTION 
57 0 14592 REQUEST OUTPUT SIZE 
58 0 14848 REQUEST STATUS 
Tt 0 16176 REQUEST VERSION. NUMBER 
52 2 13514 SCROLL CLIPPING REGION 
ax, ay 
38 1 97 29 SET ALPHABET alphabet 
69 2 7666 SET AREA CELL SIZE 
14 2 3536 SEP AREA TEXTURE’ az. -C 
3 2 770 SET AREA TEXTURE_SIZE w, h 
40 2 10242 SET CELL DISPLAY SIZE w, h 
At 2 10498 SET CELL EXPLICIT MOVEMENT 
Qk g. Sy 
42 1 LOT 3 SET CELL MOVEMENT _MODE flags 
65 i! 16641 SET_CELL_OBLIQUE angle 
43 i 11009 SET CELL RENDITION flags 
44 ik | LEZOS SET_CELL ROTATION angle 
45 2 13.522 SET CELL UNIT SIZE w, h 


PRO/GIDIS INSTRUCTION SUMMARIES 


Opcode Number of Opcode Instruction and Arguments 
Arguments Word 
16 6 4102 SET COLOR MAP ENTRY 
9 4 2308 SET _GIDIS_OUTPUT_SPACE 
Se Vr Wee 1 
Ly 3 4355 SET LINE TEXTURE 
patlen, pattern, size 
145 2 -28414 SET OUTPUT_BITMAP 
bitmap-no,dis-flag 
4 4 1028 SET OUTPUT _CLIPPING REGION ox, 
OV, Wy fh 
5 6 1286 ©. SET _OUTPUT_CURSOR 
a, Cy WwW, h, OX, OY 
72 1 18433 SET _OUTPUT_CURSOR_RENDITION 
LZ Z 3074 SET_OUTPUT_IDS w, h 
53 3 ile pele ei SET OUTPUT_RUBBER_BAND 
type, X, y 
23 4 3332 SET _OUTPUT_VIEWPORT 
| Ky. Yin We. A 
19 4 4868 SET PIXEL SIZE w, h, ox, oy 
20 1 5121 SET PLANE MASK mask 
29 Z 7426 SET_POSITION x, y 
2A i 5377 SET PRIMARY _COLOR color 
30 2 7682 SET REL POSITION dx, dy 
15 ‘8 3841 SET _SECONDARY_COLOR color 
22 1 5633 SET WRITING_MODE mode 


NN Tr  Oowm—“o 


PRO/GIDIS INSTRUCTION SUMMARIES 


Table A-3 lists report tags. 


Table A-3: Report Tags 


Tag Argument Opcode 
Number Length Word 
1 2 258 
2 9 S21 
4 it 1025 
5 4 1284 
7 2 1794 


Report Tag and Arguments 


CURRENT POSITION REPORT x,y 


OUTPUT_SIZE_ REPORT 
ulx, uly, screen_width, 
screen_height, total_width, 
total_height, resolution_x, 
resolution_y, total_plane_mask 


STATUS REPORT code 


CELL STANDARD REPORT 
uw, uh, dw, dh 


VERSION NUMBER REPORT 
code, version 
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APPENDIX C 


FONT FILE FORMAT 


This Appendix describes the memory-resident format of a font 
file. A LOAD_BY_NAME font must have this format. GIDIS requires 
the data ina, font. file to be ordered as tcl lows: 

@e header 


® pointer table 


e glyphs 


C.1 HEADER 


Header information (word wide) starts at the beginning of the 
font file. For example, Word 0 in the font is ALSMAG. Table C-1 
Shows the format of the header. 


Table C-1: Header Format 


Name Offset Description 

ALSMAG 0 Magic number--must be 16473. 
ALSSTR | Z Structure version number--102. 
ALSSIZ 4 Size of header in bytes--30. 
ALSTOT 6 Total size of font file in 


bytes--may be up to 64KB. 


HEADER 


TS eS SS Ss ret ts ssn sens sss 


Name Offset Description 

ALSFLG 8 Flags--see CREATE_ALPHABET. 

ALSRSO 10 Reserved for Patuve: 

ALSWID 12 | Width of glyphs in this font--1 to 64 
bits. 

ALSHGT 14 Height of glyph--1 to 64 bits. 

ALSFST 16 Index of first character represented in 


this font file--0O or greater. 


ALSEXT 18 Extent of font file--number of glyph 
pointers you want in the font file. 
There is no specific limit if ALSTOT is 
less than 8KB; otherwise, ALSEXT must 
not be greater than 512. 


ALSPTR 20 Offset from start of font file to 
pointer table. Pointer table must be 
present and on a word boundary. See 
Section C.2. 


ALSRS1 22 Reserved for future use. 


ALSFNT 24 Offset from start of font file to start 
of glyphs. See Section C.3. 


ALSORP 26 Offset from start of glyphs to 
out-of-range glyph, or -1. If -1, 
PRO/GIDIS will use its default 
out-of-range character. 


ALSRS2 28 Reserved for future use. 


C.2 POINTER TABLE 


The pointer table contains ALSEXT words. Note that multiple 
table entries may point to the same glyph. If a table entry 
contains -1, GIDIS treats the character as if it were out of 
range. Table C-2 shows the format of the pointer table. 


POINTER TABLE 


Table C-2: Pointer Table Format 


Name Description 

ist entry Offset from start of glyphs to the font 
information for the character with index 
ALSFST. 

2nd entry Offset from start of glyphs to the font 


information for the character with index 
(ALSFST + 1). 


Last entry Offset from start of glyphs to the font 
information for the character with index 
(ALSFST + (n-1)). 


C.3 GLYPHS 


If ALSWID is 9 to 16, each glyph must start on a word boundary. 
Otherwise, glyphs may start on byte boundaries. There are no 
wasted bytes in a glyph. For example, if ALSWID is 22 (3 bytes 
per row of a glyph) and the glyph starts at offset x, then the 
second row starts at x + 3, the third row starts at x + 6, etc. 


The leftmost pixel of a glyph is the low order bit of a -row’s 
Eirst. byte. Conversely, the rightmost pixel of a glyph is the 
first used bit of the row’s last byte. For example, let ALSWID 
be 14, and examine the first row of a glyph. The leftmost pixel 
is bit 0 of byte 0 and the rightmost pixel is bit 5 of byte 1. 


If the proportional flag is set, an extra word precedes. other 
glyph data. The first byte of this extra word is the glyph’s 
ave-width; the second byte is its left-offset. 


APPENDIX D 
MANAGING FONTS 


D.1 MAKING A FONT AVAILABLE TO GIDIS 


The .FDF files on LB:[Z2ZFONT] are files that tell the font server 
about the font files available on your system. When you boot 
your system, the font server is spawned and reads each .FDF file 


on [Z4ZFONT]. To make your fonts available in an application and 
for printing GIDIS files, have the application’s installation 
file (.INS or .INB) copy the application’s name with an .FDF 


extension (for example, APPname.FDF) to [ZZFONT]. 


An .FDF file contains one line per font file. Each line contains 
several fields. The fields are separated by spaces, but there 
may not be spaces before the first field in the line. You may 


use tabs in place of spaces. The order of fields is fixed. The 
fields must appear in the following order: 


File type A one-character field. It should be G 
for a GIDIS font file, and S for a DEC 
standard font file. S fonts are used 


only on the LNOQ3. 


Fide ;S0ec The full file specification of the font 
| file. There may be no embedded spaces. 


Family ID The font style. Note that a number of 
fonts are called DGIDIS, the family ID 
for the default GIDIS fonts. 


Ave-width For proportionally spaced: fonts, the 
average width (number of horizontal 
pixels). Of Glyons 2a 2 L2One. £ite. wor 
monospaced fonts, use the actual width 
(im pixels) Of Glyphs: 1m..this. fvelta- 
For example, the initial font on Video 
GIDIS has an ave-width of 12. 


MAKING A FONT AVAILABLE TO GIDIS 


Character cell height The height (number of vertical pixels) 
of glyphs ina font file. For example, 
the initial font on Video GIDIS has a 
height of 10. 


Region name The region name defined for the font 
when its .TSK file was built by calling 
GIFONT. 

Rendition flags Zero or more one-character fields. Each 


field defines the rendition built into 
the font. The defined options are I for 
Ltalics, B ‘for bold, P for proportionai, 
and L for limit multiplication. Use L 
to prevent a heavily multiplied low 
detail font from being selected over a 
better font. 

The following is a sample line in an .FDF file: 


G LB:[ZZFONT]DMGZ0.TSK dgidis 9 10 DGS20 L 


' =r multiplication 
region name 


cell height = 10 
cell width = 12 
default GIDIS font 
complete file specification 
indicates a GIDIS-format font file. 


You may put blank lines in an .FDF file, but no comments. 


FONT NAMING CONVENTIONS 


D.2 FONT NAMING CONVENTIONS 


A potentially large number of font files must coexist. For GIDIS 
fonts, this means their region names must coexist. Because 
region names are limited to six Radix-50 characters, not much 
name space exists. We suggest that you name fonts and regions as 
follows: 


ffcwha 

where 

ff Indicates the family ID of the font. For 
default GIDIS fonts, ff is DG. 

Cc Identifies the character set. The reserved 
values are $ for DEC Multinational (in file 
spec $ is replaced by M), P for patterns, 
and S for symbols. 

wh Specifies the ave-width and height of the font. 
encoding for each is as follows: 

X means 7 

4 means 8 

Z means 9 

0-9 means 10-19 

A-K means 20-30 

L means 32 

M means 34 

N means 36 

Z means 60 
NOTE 

Because of the limitations of the Radix-50 naming 

Space, some problems occur with this naming 

convention. You’ll note that YZ can mean a 

eharacter that 16 6 x “Sor -58°x% 60. In <such 

cases, distinguish between the two by giving each 
size a unique family ID. Note also that you 
cannot create characters with odd numbered 


ave-widths or heights greater than 30, unless you 
create your own naming convention. 


The 


FONT NAMING CONVENTIONS 


a indicates font rendition attributes. The following are 
reserved values: 


tor bold 

for bold + italics 

for bold + proportional 

for italics 

for italics + proportional 

for proportional 

for bold + italics + proportional 


Nig QGHOO 


For example the file namé DGMFF.TSK and region name DGSFF 
indicate Default GIDIS, DEC Multinational, 20 x 20, and no 
rendition attributes. 


D.3 FONTS SUPPLIED WITH GIDIS 
Three different groups of fonts are supplied with GIDIS. 


@e Monospaced default GIDIS fonts that are automatically 
installed. 


@® Optional monospaced fonts that you can install. 
@® Optional proportionally spaced fonts that you can install. 


Because font files require disk and system resources, only five 
Font files from the default font family (DG) are _ loaded 
automatically. You may choose to load other monospaced and 
proportionally spaced font families as needed. 


The following sections describe the font families and show an 
example of each. Each font family contains several font files. 
These font files contain several sizes of raster fonts and one 
stroke font. 


FONTS: SUPPL LED WITH -GiDis 


D.3.1 Default GIDIS Fonts Loaded Automatically 
Five default GIDIS (DG) fonts files are automatically installed. 


These fonts are monospaced, sans serif fonts that use the DEC 
Multinational Character Set. 


Pro/Gidis V3.0 (Dgidis 


Figure D-1: Default GIDIS Monospaced Fonts 


D.3.2 Rest of DGIDIS Monospaced Font Files 
Installing the application "Rest of DGIDIS Monospaced Font Files" 
loads twelve additional font files from the default GIDIS font 


family. These files provide additional sizes of the same style 
font. 


D.3.3 Proportionally Spaced Fonts 
You can also install several proportionally spaced fonts. 
When you install the application "Hershey Sans Serif Font," you 


load twelve sans serif font files that use the DEC Multinational 
Character Set. 


Pro/Gidis V3.0 (Dgidis 


Figure D-2: Hershey Sans Serif Font 


FONTS SUPPLIED WITH: GIDIS 


When you install the application "Hershey Serif Font," you load 
twelve serif font files that use the DEC Multinational Character 
pet. 


Pro/Gidis V3.0 (Uherser 


Figure D-3: Hershey Serif Font 


When you install the application "Hershey Italicized Serif Font," 
you load twelve italicized serif font files that use the ASCII 
Character Set. 


Pro/Gidis V3.0 (Uherser) 


Figure D-4: Hershey Italicized Serif Font 


When you install the application "Hershey Script Font," you load 
seven script font files that use the ASCII Character Set. 


Pre/Gidin V3.0 (Uherscr) 


Figure D-5: Hershey Script Font 


FONTS: SUPPLIED WITH GIDIS 


When you install the application "Hershey Gothic Font," you load 
five gothic font files that use the ASCII Character Set. 


Bro, Gridts Ys.0 (Chergat 


Figure D-6: Hershey Gothic Font 


D.4 EDITING .FDF FILES 


If you want to save resources, you can delete individual font 
files from .FDF files. For example, if you do not need certain 
sizes or do not need a stroke font, you can delete them from your 
.FDF files. 


APPENDIX E 
AREA TEXTURE AND COLOR ON THE PLOTTER 


This appendix provides information on how the Hewlett-Packard 
HP7470A and HP7475A Plotters process GIDIS instructions 
differently from other supported devices. If an instruction is 
not mentioned, it performs as described in Chapter 4. 


E.1 AREA TEXTURE 


The plotter cannot handle bit patterned textures. Instead, area 
textures used for fill are mapped to a special set of hatch 
patterns. The mapping depends on the arguments supplied with 
SET AREA TEXTURE. There are three cases: 


@ Where alphabet = -1 and char-index = 0, the plotter draws 
horizontal hatch lines about .04 inches apart using the 
current linestyle. 


@ Where alphabet = 0 through 15 and char-index = 0, the plotter 
draws a true solid fill. 


@ Where alphabet = 0 through 15 and char-index is greater than 
0, the plotter draws one of the hatch patterns shown in Table 
E-1. 


AREA 


TEXTURE 


Table E-1: Hatch Patterns for Char-Index 1 to 48 


Solid Lines 


Line Separation 
1 plus sign 

2 slash 

3 horiz. line 

4 backslash 

5 vert. line 

6 X 

Line Separation 
7 plus sign 

8 slash 

9 horiz. line 
10 backslash 

11 vert. line 


12 Xx 


Dashes 


-06 inches 


13 plus sign 
14 slash 

15 horiz. tine 
16 backslash 
17 vert. line 


18 X 


-11 inches 


19 “plus. Sign 
20 slash 

21 horiz. line 
22 backslash 
23 vert. line 


24 X 


Long Dashes 


25 plus sign 
26 slash 

27 horiz. line 
28 backslash 
29 vert. line 


30° .Xx 


31 (plus: ‘Sugn 
32 slash 

33 horiz, line 
34 backslash 
35 vert. line 


36 X 


Long/Short 
Dashes 


37 plus: sign 
38 slash 

39° Horiz. tone 
40 backslash 
41 vert. line 


42 X 


43 plus sign 
44 slash 

45 horiz. line 
46 backslash 
47 vert. line 


48 X 


The entire hatch pattern set repeats with codes 
The basic 12 patterns are shown in Figure E-1. 


through 96. 


AREA TEXTURE 
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Figure E-1: Hatch Patterns 1 through 12 


E.2 COLORS 


You control the colors in a picture by placing pens in the 
carousel as desired. You can set up any pens you like. However, 
the recommended setting for the 6-pen plotter is: 


Pen 1 - Red 

Pen 2 - Green 

Pen 3 - Blue 

Pen 4 - Yellow 

Pen 5 - Cyan 

Pen 6 - Black 
Because you control the colors, Plotter GIDIS ignores 
SET_COLOR_MAP_ENTRY. The 2-pen plotter handles colors as 
follows: 

CoLor-0 background (no pen) 

Color 175/77 left pen 

Color: 276 right pen 

Color 3 left pen slowed down 

Color 4 right pen slowed down 


COLORS 


The 6-pen plotter handles colors as follows: 


Color 0 background (no pen) 

Color J Pen 1 

Color 2 Pen 2 

Color 3 Pen 3 

Color 4 Pen 4 

Color Pen 1 slowed down slightly 
Color 6 Pen 5 

CoLeor <7 Pen 6 


APPENDIX F 
QUEUE I/O INTERFACE TO PRO/GIDIS FOR P/OS 


Earlier versions of PRO/GIDIS used the P/OS Terminal Driver to 
access Video GIDIS through Queue I/O Request (QIO) and Queue I/0 
Request and Wait (QIOW) system directives. This appendix 
contains descriptions of the directive formats. QIO error 
messages are listed at the end of each description. 


Figure F-1 depicts the instruction and parameter data path 
between your program and PRO/GIDIS. 


You can use PRO/GIDIS from MACRO-11 or any supported Tool Kit 
high-level language that supports external MACRO-11 routines. 
The recommended method is to write callable MACRO-11 routines 
that issue QIO and QIOW directives. Tool Kit FORTRAN-77 provides 
its own callable QIO and WTQIO routines in SYSLIB. 


For information on calling a MACRO-11 routine from one of the 


Tool Kit high-level languages, refer to the documentation for 
your programming language. 


F.1 THE PRO/GIDIS INTERFACE 


PRO/GIDIS instructions are sent to the graphics device with a QIO 
system directive that specifies the Write Special Data (I0O.WSD) 


I/O function code. For low-overhead, high-speed, device 
interaction, a number of PRO/GIDIS instructions can be passed to 
the graphics device at one time. Status information returns with 


the Read Special Data (IO.RSD) I/O function call. P/OS transfers 
the instruction data to and from the graphics device according to 
the request priority and device availability. 


Programs that use PRO/GIDIS also can use the Professional VT102 
terminal emulator. Normal QIO directives (IO.WLB, IO.WVB, and so 
forth) are passed to the VT102 emulator. For more information, 
refer to the description of the Terminal Driver in the P/OS 
System Reference Manual. 


THE PRO/GIDIS INTERFACE 
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Figure F-1: PRO/GIDIS Data Path 


On a Single-plane system, both GIDIS and the VT102 emulator draw 
on the same plane and overwrite each other’s data. On a 
three-plane system, the VT102 emulator only draws on plane three. 


Be2 


THE PRO/GIDIS INTERFACE 


Thus, if PRO/GIDIS modifies only planes one and two, there will 
be minimal interference. The SET_PLANE_MASK instruction 
Specifies which planes PRO/GIDIS can modify. 


The vT102 emulator scrolls all three planes when the scrolling 
region is set to the entire screen. Any graphics information in 


any plane scrolls with the text. If the scrolling region is 
smaller than the entire screen, the vT1i02 emulator redraws the 
characters in their new positions. This does not scroll or 


otherwise affect graphics information in planes one and two but 
it erases graphics information in plane three. 


You can send an RIS (Reset to Initial State - <ESC>c) escape 
sequence to the VT102 emulator in order to reset both the vTi02 
emulator and PRO/GIDIS to their initial states. PRO/GIDIS 
immediately performs an "INITIALIZE -1" instruction, clears the 
bitmap, and expects an opcode as the next word in the 
instruction/data stream. Thus, you can use RIS to ensure that 
your program and PRO/GIDIS are "in synch" when your- program 
starts up. You cannot use it arbitrarily in the middle of 


picture generation because of the global initialization effect. 


The QIO and QIOW directives are described in detail in the P/OS 
System Reference Manual. The examples in this appendix show the 
SS forms for clarity. The $C and $ forms can be used as well. 


IO.WSD and IO.RSD are resolved in the normal manner for system. 
symbols: the Application Builder gets them from module QIOSYM in 
SYSLIB.OLB. This works correctly in MACRO-11 but may not work 
with languages that have symbol naming restrictions. For 
example, FORTRAN-77 does not permit periods in symbol names. 


F.1.1 Write Special Data (lO.WSD) 


The write-special-data QIO function directs one or more 
instructions to PRO/GIDIS. The instructions and their associated 
parameter values are passed in a buffer that must have an even 
address. 


The MACRO-11 format for the Write Special Data QIO (or QIOW) call 
is shown below. 


NOTE 


The punctuation marks and the items in bold are 
mandatory; mnonbold items are optional. Items in 
uppercase letters must be used exactly as_ shown. 
Items in lowercase letters must be replaced as 
described. 


THE PRO/GIDIS. INTERFACE 


QIOWSS #IO.WSD,LUN,efn,pri,isb,ast,<buffer, length, ,#SD.GDS> 
LUN Is a logical unit number assigned to the terminal. 


efn Is an event flag number (required with the synchronous 
wait form QIOW). 


pri Is the priority (ignored but must be present). 
isb Is the address of the I/O status block. 
ast Is the address of the AST service routine entry point. 


buffer Is the address of the buffer containing PRO/GIDIS 
instructions and parameters. 


length Is the length of the PRO/GIDIS instruction/parameter 
buffer (specified as an even number of bytes in the range 
2) 40: BA 23:) 2 


SD.GDS Is a data type parameter that indicates PRO/GIDIS output. 


The QIO system directive returns status in a special global 
variable called SDSW. Some possible values are: 


LS2oUC Successful completion 
TE stLu Invalid logical unit number 
LB 2LEF Invalid event flag number 


For a full list of error codes, refer to the QIO directive 
description and the terminal driver section of the P/OS System 
Reference Manual. 


When the QIO directive is successful, it can return the following 
status codes in the I/O status block. 


LO.SUC Successful completion 
Lon PND I/O request pending 
IE.ABO Operation aborted 
IE.DNR Device not ready 


F.1.2 Read Special Data (lO.RSD) 


The read-special-data QIO function reads reports placed in the 
report queue by the following PRO/GIDIS report-request 
instructions: 


THE PRO/GIDIS INTERFACE 


O REQUEST _CURRENT_POSITION 
O REQUEST STATUS 
@) REQUEST_CELL_ STANDARD 
These instructions are detailed in Chapter 6. 


The MACRO-11 format for the Read Special Data QIO or QIOW call is 
Shown below. | 


NOTE 


The punctuation marks and the items in bold are 
mandatory. Nonbold items are optional. Items in 
uppercase letters must be used exactly as shown. 
{Items in lowercase letters must be replaced as 
described. 


QIOWSS #10.RSD,LUN,efn,pri,isb,ast,<buffer, length, ,#SD.GDS> 
LUN Is a logical unit number assigned to the terminal. 


efn Is an event flag number (required with the synchronous 
wait form QIOW). 


pri Is the priority (ignored but must be present). 
isb Is the address of the I/O status block. 
ast Is the address of the AST service routine entry point. 


buffer Is the address of the buffer to contain PRO/GIDIS' report 
data. 


length Is the length of the PRO/GIDIS report buffer (specified 
as an even number of bytes in the range 2 to 8128). 


SD.GDS Is a data type parameter that indicates PRO/GIDIS output. 


If there is no data available, the QIO waits until enough data to 
fill the buffer becomes available. During this wait, no IO.WSD 
(write special data) is performed, even if the no-wait form was 
used. To avoid deadlock, the preferred method is to issue a 
QIOSW for the exact number of bytes expected after the request 


INMSETUCTION: 26, SEN. 0G: -PRO/SGIDLS: 


THE PRO/GIDIS INTERFACE 


The QIO system directive returns status in a special global 
variable called SDSW. Some possible values are: 


IS.SUC Successful completion 
LE. GU Invalid logical unit number 
TEoLEP Invalid event flag number 
For a full list of error codes, refer to the QIO directive 


description and the terminal driver section of the P/OS System 
Reference Manual. 


When the QIO directive is successful, it can return the following 
status codes in the I/O status block. 


IO.SUC Successful completion 
rS<PND I/O request pending 
IE.ABO Operation aborted 
IE.DNR Device not ready 


F.2 PRO/GIDIS INSTRUCTION SYNTAX 
The instructions syntax remains the same whether GIDCAL or QIO 


system directives are used to access PRO/GIDIS. See Chapter 3 
for details. 


F.3 SAMPLE MACRO-11 PROGRAM 


IOSB: . BLKW oe 
OBUE-: BYTE Qikgeoos ;Length=0 REQUEST_CURRENT_POSITION 
RBUF: . BLKW om 


>SEND INSTRUCTION TO PRO/GIDIS 
QIOWSS #1I0O.WSD,#5,#1,,#1IOSB,,<#OBUF,#2,,#SD.GDS> 


BCS ERROR ; DIRECTIVE FALLED 
TSTB ITOSB 
BLE ERROR ;OPERATION FAILED 


;READ THE REPORT 
QIOWSS #I0O.RSD,#5,#1,,#IOSB,,<#RBUF,#6,,#5D.GDS> 


BCS ERROR ;BRANCH IF DIRECTIVE FAILED 
TSTB IOSB 


BLE ERROR ;BRANCH IF OPERATION FAILED 


; NEW CONTENTS OF RBUF: 
> BYTE AT RBUF 2. (LENGTH) 
; BYTE AT RBUF+1 1. 
; (CURRENT POSITION REPORT TAG) 
; RBUF+2: CURRENT .~ -POSLTION 
: ; RBUF+4: CURRENT: ¥- POSITION 
ERROR: ; Error handling routine 
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SAMPLE MACRO-11 PROGRAM 


F.4 SAMPLE FORTRAN PROGRAM 


INTEGER*2  SDGDS, IOWSD, IORSD, ISSUC 

PARAMETER (SDGDS=1), (IOWSD="5410), (IORSD="6030), (ISSUC=1) 
INTEGER*2 IOSB(2), IDS, OBUF 

INTEGER*2 RBUF(3),PARLST(6) 


OBUF = 55%*256+0 !OPCODE 55=REQUEST_CURRENT_POSITION 
! LENGTH=0 

CALL GETADR(PARLST(1),OBUF) ! ADDRESS 

PARLST(2) = 2 !'LENGTH=2 BYTES 

PARLST(4) = SDGDS 


CALL WTQIO(IOWSD,5,1,0,10SB,PARLST,IDS) 
IF (IDS.NE.ISSUC) GO TO 999 {DIRECTIVE FAILED 
ITF (TOSB(1)«NEuTSSUC). GO: TO: 999 {T/O REQUEST FAILED 


CALL GETADR(PARLST(1),RBUF) 
PARLST(2) = 6 'EXPECTED LENGTH OF REPORT IN BYTES 


CALL WTQIO(IORSD,5,1,0,I0SB,PARLST,IDS) 
IF (IDS.NE.ISSUC) GO TO 999 !'DIRECTIVE FAILED 
IF (IOSB(1).NE.ISSUC) GO TO 999 'IT/O REQUEST FAILED 


{! NEW CONTENTS OF RBUF: 

LY RBUF(1L)s 258 

! REPORT TAG = 1%*256+2 | 

! 1 = THE REPORT TAG AND 2 = LENGTH OF DATA FOLLOWING 
t 


RBUF(2): CURRENT X POSITION IN GIDIS OUTPUT SPACE 
RBUF(3): CURRENT Y POSITION IN GIDIS OUTPUT SPACE 
goo ! ERROR FOUND 


APPENDIX G 
GLOSSARY 


The words in this glossary are used throughout this manual. 
These definitions are not absolute and might differ somewhat in 
other contexts. Where possible, the most common computer 
industry usage is the basis of the definition. 


alphabet 
A collection of characters. The character indexes’ are 
numbered 0,1,...n-1, where n is the extent of the alphabet. 


anisotropic 
An uneven ratio of width to height. In an anisotropic 
coordinate space, one unit in the X direction is not equal 
in size to one unit in the Y direction. 


area texture 


The two-dimensional binary pattern that you select to’ shade 
filled figures. 


aspect ratio 
The ratio of the width of an object to its height. Objects 
whose aspect ratio are important in graphics include video 
displays, pixels, and address spaces. 


attribute 
A property that tells GIDIS something about how to do_ the 
specified drawing operation. For example, when you tell 


GIDIS to draw a line, one of the attributes used in drawing 
the line is current primary color. 


bitmap 
The rectangular array of pixels (picture elements) that 
constitutes the view surface of a dot-oriented device. Also 
known as a raster or frame buffer. The Professional 350 has 
a bitmap 960 pixels wide by 240 pixels high. 


GLOSSARY 


character 
A graphic symbol, such as a letter, number, or other 
typewritten symbol. In GIDIS, characters are elements in an 


alphabet. A character is uniquely identified by specifying 
its alphabet number and its index within the alphabet. 


Character cell 
(See display cell or unit cell.) 


clipping 
Clipping means displaying only part of what is drawn. In 
GIDIS, you can select a clipping rectangle. What you draw 
inside the rectangle is displayed; what you draw outside the 
rectangle is not displayed. 


color 
In GIDIS the term has a double meaning. It has its usual 
"real world" meaning, and it also means an index into the 
GIDIS color map. 


color map 
A table whose entries contain a description of how to 
generate a particular color. In GIDIS this description is 
in terms of red, green and blue intensities. For example, 
bright yellow results from a maximum intensity of red, a 
maximum intensity of green, and a zero intensity of blue. 


complement 
The writing mode in which the foreground and background 


colors are reversed. 


current position 
The position in relation to which lines, arcs, and 


characters are drawn by GIDIS. 


cursor 
The marker displayed by GIDIS at the current position. 


display ceil 

In GIDIS text processing, the display cell is that area of 
the view surface in which a unit cell is drawn. The top 
left corner of the unit cell is always placed at the top 
left corner of the display cell. Any portion of the display 
cell not covered by the unit cell is treated as though the 
unit cell is OFF for that area. If the unit cell is larger 
than the display cell, the unit cell is clipped at the 
display cell borders. 


GLOSSARY 


filled figure 
To GIDIS, a figure is any sequence of connected lines and 
arcs. A filled figure is just a figure whose interior has 
been painted with the area texture of your choice. 


font family 
Loosely speaking, the style in which an alphabet is drawn, 
for example, Courier. 


font file 
The collection of glyphs and attribute information used by 
GIDIS to draw characters for a particular font. 


GIDIS Output Space (GOS) 
The isotropic coordinate space you set up for GIDIS to _ use 
in all drawing and report operations. A location within GOS 
maps to a location within your viewport. 


global symmetry 
Preservation of GIDIS Output Space relationships at the 


expense of Hardware Address Space relationships. For 
example, assume a ten-unit distance in GIDIS output space 
maps to 7.5 hardware pixels. With global symmetry, 


repeatedly moving ten GIDIS output space units results in a 
move of seven hardware pixels, then eight hardware pixels, 
then seven, and so forth. With local symmetry, repeatedly 
moving 10 GIDIS Output Space units always results in a move 
of 7 hardware pixels. 


glyph 
The data ina font file that tells GIDIS how to draw a 
particular character. In other words, it is the internal 
representation of a character. 


Hardware Address Space (HAS) 
The coordinate space (possibly anisotropic) used by a 
graphic output device. GIDIS hides this space from your 
program, and addresses the device’s view surface through an 
isotropic Imposed Device Space. 


image 
A figure as defined in Imposed Device Space. In GIDIS you 
can display an image on a variety of output devices. 


Imposed Device Space (IDS) 
The isotropic coordinate space imposed on the device’s view 
surface. You use IDS only to set the viewport. All other 
coordinates are in GIDIS Output Space (GOS). 


GLOSSARY 


isotropic 
A 1:1 ratio of width to height. In an isotropic coordinate 
Space one unit in the X direction is equal in size to one 
unit in the Y direction. 


line texture 
A linear pattern used to draw lines. Examples are solid, 
dashed, dotted, and so. forth. PRO/GIDIS enables you to 
define any two-color pattern up to 16 units in length. 


local symmetry 
Preservation of Hardware Address Space relationships at the 
expense of GIDIS Output Space relationships. For example, 
assume a ten-unit distance in GIDIS output space maps to 7.5 
hardware pixels. With local symmetry, repeatedly moving 10 
GIDIS Output Space units always results in a move of 7 
hardware pixels. With global symmetry, repeatedly moving 
ten GIDIS output space units results in a move of seven 
hardware pixels, then eight hardware pixels, then seven, and 


so forth. 
origin . 
The origin of an address space is the point [0,0]. In 


PRO/GIDIS, the origin of IDS is always the upper left corner 
of the device’s view surface. The origin of GIDIS output 
Space is set by your program. 


The origin of a character cell (either display cell or unit 


cell) is the point in the cell placed over the current 
position. This is also the point about which the cell 
rotates. 

picture 
A figure as defined in GIDIS Output Space. Once defined, 


you can store it in a file or map it to a viewport for 
display on a view surface. 


pixel (picture element) 
The smallest element of a view surface that can be assigned 
a color or intensity. In a single plane device, it is one 
bit in the bitmap. 


pixel aspect ratio 
The ratio of the width of a pixel to its height. The width 
is the horizontal distance between adjacent pixels, and the 
height is the vertical distance. Pixel aspect ratio 15 
normally expressed as two small numbers, for example, 1:2. 
The pixel aspect ratio on the Professional 350 monitor is 
220% 


GLOSSARY 


plane 


A view surface that has N bits per pixel (that is, a pixel 
can be one of 2**N colors) is said to have N planes. A 
plane is a slice of a bitmap that contains one bit for each 
pixel. 


primary color 


The color index used to draw on-bits in area textures, line 
textures, and glyphs. GIDIS enables you to set the current 
Primary color. 


rubber band 


A rubber band is a marker that shows the current position 
relative ©O ad point. of ‘your choice, called the origin. 
There are two types of rubber bands available in PRO/GIDIS: 
the rubber band line and the rubber band rectangle. The 
line stretches from the rubber band origin .-to the current 
position. The rectangle has one corner at the rubber band 
Origin and the opposite corner at the current position. The 
rectangle will degenerate to a line or point if the current 
position and rubber band origin are the same in one or both 
coordinates. 


secondary color 


The color index that indicates the absence of the drawing 
color. Thus its main function is to serve as the background 
color of a picture. In replace mode, it is also used to 
draw off-bits in area textures, line textures, and glyphs. 
GIDIS enables you to set the current secondary color. 


standard display size 


The standard display size is normally equal to the standard 


unite size. However, for alphabet 0 the standard display 
size is slightly smaller (horizontally) than the standard 
unit. size. This is for increased compatibility with the 
We LZ 


standard unit size 


The size in GIDIS Output Space of a character such that 80 
characters would fit horizontally and 24 characters would 
fit vertically, when IDS width/height is 8/5. 


stroke device 


text 


A device whose view surface is written to with pen strokes, 
in contrast to a bitmap device, whose surface is written to 
with a sequence of dots. 


rendition 
The ‘variations -of -cnaracter appearance, BOL example, 
bolding and italics are renditions. 


GLOSSARY 


unit cell | 
In GIDIS, a character is viewed as a rectangular field of ON 
and OFF bits. ON bits form a character pattern; OFF bits 


form the background. 


viewport 
A rectangle within Imposed Device Space. You place this 
rectangle where you want the image to be displayed. 


view surface 
The part of the device upon which drawing can occur. For 
example, the screen is the view surface of the Professional 


Video monitor. 


viewing transformation 
The process of mapping graphic data from user coordinate 


Space to display coordinate space. 


window 
A rectangle you define within GIDIS Output Space to control 


which part of your picture to map to a viewport. 


INDEX 


Absolute position 
in GIDIS instructions, 2-12 
Addressing 
controlling with 
SET _GIDIS_OUTPUT_SPACE, 
2-10 
Alphabet 
and REQUEST_CELL_ STANDARD, 6-49 
current, 2-22 
definition, 2-22, G-1 
in relation to font, 2-22 
number available, 2-22 
reset state, 6-39 
selecting current with 
SET ALPHABET, 2-22 
Alphabet and font instructions 
Summary of, 2-24 
Anisotropic 
definition, G-l 
Application management 
instructions 
definition of, 2-9 
ERASE_CLIPPING_REGION, 2-10 
FLUSH BUFFER, 2-10 
SCROLL_CLIPPING_REGION, 2-10 
SET_GIDIS_OUTPUT_SPACE, 2-10 
SET_OUTPUT_BITMAP, 2-11 
SET OUTPUT _CLIPPING_REGION, 
2-10 
SET_OUTPUT_CURSOR, 2-10 
SET OUTPUT _CURSOR_RENDITION, 
2-10 
SET OUTPUT _RUBBER_BAND, 2-10 
SET_OUTPUT_VIEWPORT, 2-10 
used interactively, 2-9 
Arcs 
drawing, 6-14, 6-23 
Area cell size 
setting, 6-59 
Area texture 
affected by 
SET _GIDIS_OUTPUT_SPACE, 
6-84 
affected by SET_OUTPUT_IDS, 
6-97 
definition, G-l 
reset state, 6-39 


setting, 6-61 

taken from line texture, 6-61 
Area texture size 

setting, 6-63 
Argument list 

counted, 3-2 

length byte in, 3-2 

uncounted, 3-2 
Argument word(s) 

fixed number of, 3-1 

format of, 3-1 

variable number of, 3-1 
Aspect ratio 

definition, G-1 
Associated documents, xi 
Attribute 

definition, G-1 


Back-slant 
character rendition, 2-20 
BEGIN_DEFINE_CHARACTER 
aborted by initialization, 6-36 
reference description, 6-2 
used to define glyphs, 2-23 
BEGIN_FILLED_FIGURE 
aborted by initialization, 6-36 
drawing instruction, 2-13 
reference description, 6-7 
Bitmap 
definition, G-1 
Bold 
character rendition, 2-20 


Cartesian coordinate space, 2-8 
Cell display size 
affected by 
SET GIDIS_OUTPUT_SPACE, 
6-84 
affected by SET_OUTPUT_IDS, 
6-97 
reset state, 6-39 
Cell movement 
affected by 
SET _GIDIS_OUTPUT_SPACE, 
6-84 
affected by SET_OUTPUT_IDS, 
6-97 


Index-1 
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reset state, 6-39 
Cell oblique 
reset state, 6-39 
Cell rendition 
reset state, 6-39 
Cell rotation 
reset state, 6-39 
Cell unit size 
affected by 
SET GIDIS_ OUTPUT SPACE, 
6-84 
affected by SET_OUTPUT_IDS, 
6-97 
reset state, 6-39 
Centerpoint 
of arcs, 2-12 
CGL 
relationship to PRO/GIDIS, 1-2 
Character 
definition, G-2 
Character cell 
changing the shape of, 2-20 
definition, 2-17, G-2 
display cell size, 2-17 
renditions available, 2-20 
rotating, 2-17 
shape of, 2-20 
types of, 2-17 
unit cell size, 2-17 
Character cell rendition 
specifying with 
SET CELL RENDITION, 2-20 
Character rotation 
and REQUEST CELL STANDARD, 6-49 
Clipping 
area texture cell, 2-17 
definition, 2-3, G-2 
Clipping rectangle 
changing the size of, 2-8, 2-10 
reasons to change the size of, 
2-10 
size of, 2-10 
Clipping region 
affected by 
SET -GIDLSs. OUTPUT. SPACE, 
6-84 . 
affected by SET _OUTPUT_IDS, 
6-97 
erasing, 6-33 
setting, 6-89 
Color 


definition, G-2 
Color map 
definition, G-2 
interaction with plane mask, 
6-104 
reset state, 6-39 
setting, 6-78 
values, 6-79 
Complement 
defintion, G-2 
Complement mode 
effect on filled figure, 6-8 
effect on lines, 6-19, 6-26 
effect on pixel size, 6-103 
Complement negate mode 
effect on filled figure, 6-8 
effect on lines, 6-19, 6-26 
CORE Graphics Library 
see CGL 
CREATE_ALPHABET 
and dynamically created fonts, 
2-23 | 
disadvantages of, 2-23 
in uncounted argument list, 3-1 
options with, 2-23 
reference description, 6-11 
storing fonts created with, 
2-23 
Current position 
affected by 
SET _GIDIS OUTPUT_SPACE, 
6-84 
affected by SET_OUTPUT_IDS, 
6-97 
after DRAW_ARCS, 6-14 
after DRAW _REL ARCS, 6-23 
changing as a result of drawing 


instruction, 2-12 
changing with SET_POSITION, 
2-12 


changing with 

SET RELATIVE POSITION, 
definition, 2-12, G-2 
marking with cursor, 2-10 
marking with rubber band, 2-10 
Opervons An updating; Zeal] 
reporting, 6-51 
reset state, 6-39 
setting, 6-106, 6-108 
updating of; 2212 

Cursor 


2-12 


Index-2 


affected by 
SET_GIDIS_OUTPUT_SPACE, 
6-84 

affected by SET _OUTPUT_IDS, 
6-97 

definition, G-2 

rendition, 2-10 

reset state, 6-39 

selecting built-in, 

setting, 6-91 

used to mark the current 
position, 2-10 

Curve attributes 
setting, 2-16 


6=9'2 


Device’s view surface 
how to describe, 2-8 
origin of, 2-8 

Devtype 0 
Disk file, 

Devtype 1 
LA 50, 

Devtype 2 
LQPO2, 

Devtype 3 
LA100, 

Devtype 4 
HP7470, 4 
HP7475, 4 
LVP16, 4- 

Devtype 5 
other, 

Devtype 6 
Professional video, 

Devtype 7 
LNO3, 4-9 

Devtype 8 
Palette, 

Disk file 
Devtype 0, 

Display cell 
definition, G-2 
reporting, 6-49 

Display cell size 
definition of, 

DRAW_ARCS 
and END_LIST, 


4-7 
4-8 

4-8 

4-8 

-8 

-8 

8 
4-9 


4-9 


4-9 


4-7 


2-17 


6-30 


INDEX 


and REQUEST_CURRENT_POSITION, 


6-51 
drawing instruction, 2-12 
in uncounted argument list, 


3=1 


reference description, 
DRAW_CHARACTERS 


and END_LIST, 6-30 


6-14 


and REQUEST_CURRENT_POSITION, 


6-51 
drawing instruction, 2-13 
in uncounted argument list, 


invalid in filled figure, 6- 


reference description, 6-17 
DRAW_LINES 

and END_LIST, 6-30 

drawing instruction, 2-12 


in uncounted argument list, 
reference description, 6-19 
DRAW_PACKED CHARACTERS 
and END_LIST, 6-30 
drawing ASCII strings with, 
2-13 

drawing instruction, 2-13 
in uncounted argument list, 


invalid in filled figure, 6- 


reference description, 6-21 
DRAW_REL_ ARCS 
and END LIST, 6-30 
drawing instruction, 2-12 
in uncounted argument list, 
reference description, 6-23 
DRAW_REL_LINES 
and END_LIST, 6-30 
drawing instruction, 2-12 
in uncounted argument list, 
reference description, 6-25 
Drawing arcs 
in a series, 
individually, 


2-12 
2-12 


relationship of endpoint and 


current position, 2-12 


3-1 
7 


ewe 


32k 
7 


3-1 


3-1 


specifying centerpoint of, 2-12 


with DRAW_ARCS, 2-12 
with DRAW_REL_ ARCS, 

Drawing Attributes 
classes of attributes, 
default values, 2-14 
role of, 2-14 

Drawing characters 
drawing characters in 

succession, 2-13 

rendition of, 2-13 
role of SET ALPHABET in, 


2-12 


2-14 


2-13 


selecting a current alphabet, 


2-13 


Index-3 


selecting the character you 
want to draw, 2-13 
with DRAW_CHARACTERS, 2-13 
with DRAW_PACKED_ CHARACTERS, 
2-13 
Drawing filled figures 
and END_FILLED_FIGURE, 2-13 
order of drawing instructions, 
2-13 
Drawing filled figuresand 
BEGIN_FILLED_ FIGURE, 2-13 
Drawing instructions 
function: of, -2=12 
summary of, 2-13 
Drawing lines 
in a series, 2-12 
individually, 2-12 
relationship of endpoint and 
current position, 2-12 
setting thickness of, 2-16 
with DRAW LINES, 2-12 
with DRAW_REL_LINES, 2-12 
SDSW variable 
values of, F-4, F-6 


END_DEFINE CHARACTER 
reference description, 6-28 
used with 

BEGIN DEFINE CHARACTER, 
2-23 

END FILLED FIGURE 
drawing instruction, 2-13 
reference description, 6-29 

END LIST 
and DRAW ARCS, 6-14 
and DRAW LINES, 6-19 
and DRAW_REL_ARCS, 6-23 
and DRAW_REL_LINES, 6-25 
function of, 3-2 
reference description, 6-30 

END PICTURE 
reference description, 6-31 

Endpoint 
of lines, 2-12 

ERASE_CLIPPING REGION 
reference description, 6-33 
used to clear space within 

viewport, 2-10 

Error 

in instruction stream, 3-3 


INDEX 


Family name 
see font 
-FDF files 
description of, D-1 
fields in, D-1 
format of, D-1 
Filled figure 
and DRAW _LINES, 6-19 
and DRAW _REL LINES, 6-26 
defining, 6-7 
definition, G-3 
effect on DRAW_ARCS, 6-14 
effect on DRAW_REL_ ARCS, 6-23 
ending, 6-29 
Filled figure attributes 
setting, 2-16 
Filled figure table 
definition of, 2-13 
FLUSH_BUFFER 
and END_PICTURE, 6-31 
reference description, 6-34 
used to control user input, 
2-10 
Font 
definition, 2-22 
family name, 2-22 
in relation to alphabet, 2-22 
Font family 
definition, G-3 
Font file 
definition, G-3 
header format, C-1 
location of glyphs in, C-3 
order of data, C-1l 
pointer table format, C-2 
required format, C-1 
Font files 
creating, 2-22 
directory of, D-1 
managing, D-1 
storing, 2-22 
table of available fonts, D-1 
Font server 
spawned at boot time, D-1 
Fonts 
attributes, D-4 
building with CREATE_ALPHABET, 
2-22 
building with LOAD_BY_NAME, 
2-22 
how to build, 2-22 
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naming conventions, D-3 
necessity of more than one, 
2-22 
number available, 2-22 
stored in font files, 2-22 
FORTRAN sample program 
RT-11, 5-13 
FORTRAN-77 


PRO/GIDIS instruction names in, 


3-2 
sample program, 4-15, F-7 
symbol name restrictions, F-3 
use of with PRO/GIDIS, F-1 


GICLOS 
arguments for, 4-5 
description of, 4-5 
GICLOS RT-11 
arguments for, 5-5 
description of, 5-5 
GIDCAL 
see GIDIS Call Interface 
GIDIS attributes 
and SET_GIDIS_OUTPUT_SPACE, 
| 6-84 
and SET _OUTPUT_IDS, 6-95 
GIDIS Call Interface 
accessing routines, 4-2 
advantages of, 1-2 
devices accessed by, 4-7 
driver-specific instructions, 
4-11 
errors, 4-1 
GICLOS, 4-1 
GIFONT, 4-1 
GIOPEN, 4-1 
GIPLAY, 4-1 
GIREAD, 4-1 
GIWRIT, 4-1 
maintain multiple connections, 
4-2 
routines, 4-1 
status code returned, 4-2 
using, 4-2 
GIDIS Call Interface RT-11 


errors, 5-5 
GICLOS, 5-2 
GIOPEN, 5-2 
GIREAD, 5-2 
GIWRIT, 5-2 


interface errors, 5-6 


INDEX 


MACRO-11 interface 
data path, 5-10 
operating system errors, 5-6 
routines, 5-2 
using, 5-2 
GIDIS instructions 
repeatable, 3-1 
GIDIS Output Space (GOS) 
address space used by drawing 
instructions, 2-8 
affected by SET_OUTPUT_IDS, 
6-97 
reset state, 6-39 
setting, 6-81 
GIFONT 
arguments for, 4-6 
description of, 4-6 
used to store CREATE ALPHABET 
fonts, 2-23 
GIGI 
and ReGIS, 1-2 
GIOPEN 
and choosing a driver, 4-3 
arguments for, 4-3 
description of, 4-3 
device types accessed, 4-3 
GIOPEN RT-11 
arguments for, 5-3 
description of, 5-3 
GIREAD 
arguments for, 4-4 
description of, 4-4 
GIREAD RT-11 
arguments for, 5-4 
description of, 5-4 
GIWRIT 
arguments for, 4-4 
description of, 4-4 
GIWRIT RT-11 
arguments for, 5-4 
description of, 5-4 
Global symmetry 
and SET REL POSITION, 6-108 
definition, G-3 
Glyph 
defined with 
BEGIN _DEFINED_CHARACTER, 
2-23 
defined with 
LOAD CHARACTER_CELL, 2-23 
definition, G-3 


Index-5 


INDEX 


location in font file, C-3 
GOS 
see GIDIS Output Space 


Hardware Address Space (HAS) 
aS anisotropic address space, 
2-8 
definition of, 2-8 
HAS 
definition, G-3 
HAS (Hardware Address Space) 
see Hardware Address Space 
Header format 
for font file, C-1 
HP7470 
Devtype 4, 4-8 
HP7475 
Devtype 4, 4-8 


I/O Status Block 
values of, F-4, F-6 
IDS 
definition, G-3 
IDS (Imposed Device Space) 
see Imposed Device Space 
Image 
definition, G-3 
Imposed Device Space (IDS) 
as device-independent address 
Space, 2-8 
as isotropic address space, 2-8 
definition of, 2-8 
reset state, 6-39 
resolution of, 2-8 
set by SET_OUTPUT_IDS, 2-8 
setting, 6-95 
setting coordinates of, 2-8 
Shape of, 2-8 | 
INITIALIZE 
and RIS, F-3 
effect on filled figure, 6-8 
reference description, 6-35 
Instruction syntax 
description, 3-1 
Interactive control instructions 
summary of, 2-11 
IO.RSD function code 
format, F-5 
in QIO, F-1 
use of, F-4, F-6 
IO.WLB function code 


and VT102 Emulator, F-1 
IO.WSD function code 

format, F-4 

in QIO, F-1 

use of, F-3, F-4 
IO.WVB function code 

and VT102 Emulator, F-1 
Isotropic 

definition, G-4 
Italics 

character rendition, 2-20 


LA 50 
Devtype 1, 4-8 
LA100 
Devtype 3, 4-8 
LBs [ ZZFONT ] 
font file directory, D-1 
Length byte 
in argument list, 3-2 
Line 
drawing, 6-19, 6-25 
Line attributes 
setting, 2-16 
Line texture 
affected by 
SET _GIDIS_OUTPUT_SPACE, 
6-84 
affected by SET_OUTPUT_IDS, 
6-97 
definition, G-4 
reset state, 6-39 
setting, 6-86 
LNO3 
Devtype 7, 4-9 
LOAD_BY_NAME 
formats of, 2-23 
in uncounted argument list, 3-1 
LOAD _BY_NAME(1) 
reference description, 6-40 
uses of, 2-23 
LOAD_BY_NAME(2) 
reference description, 6-42 
uses of, 2-23 
LOAD _CHARACTER_CELL 
in uncounted argument list, 3-1 
reference description, 6-43 
used to define glyphs, 2-23 
Local symmetry | 
definition, G-4 
LQPO2 


Index-6 
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Devtype 2, 4-8 
LVP16 
Devtype 4, 4-8 


MACRO-11 
PRO/GIDIS instruction names in, 
3-2 
sample program, 4-14, F-6 
use of with PRO/GIDIS, F-1 
MACRO-11 interface 
with RT-11, 5-10 
MACRO-11 sample program 
RT-11, 5-12 
Mapping 
window to viewport, 2-3 


NAPLPS 
relationship to PRO/GIDIS, 1-2 
NEW_PICTURE 
reference description, 6-45 
use of, 6-45 
NOP 
reference description, 6-46 


Opcode 
function of, 3-1 
Opcode word 
format, 3-1 
Orientation of character 
definition of, 2-19 
determined by angle specified, 
2-19 
specified by SET_CELL_ROTATION, 
2-19 
Origin 
definition, G-4 
of device’s view surface, 2-8 
Other 
Devtype 5, 4-9 


Palette 
Devtype 8, 4-9 
errors, 4-10 
PASCAL 


PRO/GIDIS instruction names in, 


3-2 
Picture 
definition, G-4 
Picture management instructions 
function of, 2-6 
Summary of, 2-9 


Pixel 
definition, G-4 
Pixel aspect ratio 
definition, G-4 
Pixel size | 
setting, 6-102 
Plane 
definition, G-5 
Plane mask 
reset state, 6-39 
setting, 6-104 
Plotter GIDIS 
area texture, E-1 
color with, E-3 
hatch patterns used with, E-2 
loading pens with, E-3 
2-pen plotter, E-3 
6-pen plotter, E-3 
Pointer table format 
for font file, C-2 
Primary color 
definition, G-5 
reset state, 6-39 
setting, 6-107 
PRINT SCREEN 
reference description, 6-47 
used to print portion of video 
bitmap, 2-11 
PRO/Document VDM 
relationship to GIDIS, 1-3 
PRO/GIDIS 
as foreground job under XM 
monitor, 5-1 
conceptual framework of, 2-1 
definition of, i-1 
devices supported with P/OS, 
1-2 
devices supported with RT-11, 
1-2 
interface, 1-3 
relationship to other P/OS 
graphic tools; 2=2 
RT-11 
files required, 5-1 
FORTRAN interface, 5-1 
GIDIS Call Interface, 5-1 
interfaces, 5-1 
MACRO-11 interface, 5-1 
Professional INTERFACE (PTI) 
handler, 5-1 
starting, 5-1 
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sample output, 1-1 

use of fallbacks, 1-2 

uses of, 1-1 

when to use, 1-4 
PRO/GIDIS attributes 

summary of, 2-20 
PRO/GIDIS instruction 

definition of, 3-1 
PRO/GIDIS instruction summary 

in alphabetical order, A-5 

in opcode order, A-1 
PRO/GIDIS RT-11 

FORTRAN interface, 5-13 

MACRO-11 interface, 5-10 
Professional video 

Devtype 6, 4-9 
Proportional text 

character rendition, 2-20 


QIO 
access to PRO/GIDIS, F-1, F-7 
expansion forms, F-3 
FORTRAN-77 routine, F-1 

QIOW 
see QIO 

Queue I/O Request 
see QIO 


Read Special Data 
see IO.RSD 
ReGIS 
relationship to PRO/GIDIS, 1-2 
when to use, 1-4 
Relative position 
in GIDIS instructions, 2-12 
Remote Graphics Instruction Set 
see ReGIS 
Rendition 
available for character cells, 
2-20 
Report instructions 
function of, 2-25 
REQUEST _CURRENT_POSITION, 2-25 
REQUEST STATUS, 2-25 
summary of, 2-25 
Report tags, A-8 
Reports 
how to read, 2-25 
why use, 2-25 
REQUEST CELL STANDARD 
and IO.RSD, F-9§ 


INDEX 


reference description, 6-49 
REQUEST CURRENT POSITION 

and IO.RSD, F-5 

reference description, 6-51 

uses of, 2-25 
REQUEST_OUTPUT_SIZE 

reference description, 6-52 
REQUEST_STATUS 

and IO.RSD, F-5 

cost of, 2-25 

reference description, 6-54 

uses of, 2-25 
REQUEST_VERSION_NUMBER 

reference description, 6-55 
Reset to Initial State (RIS) 

use of, F-3 
RIS (Reset) escape sequence 

use of, F-3 
RT-11 

requirements for using 

PRO/GIDIS, 5-1 

Rubber band 

definition, G-5 

rendition, 2-10 

used to mark the current 

position, 2-10 


Scaling pictures 
with SET _GIDIS_ OUTPUT SPACE, 
2-10 
screen 
printing, 6-47 
SCROLL_CLIPPING_ REGION 
reference description, 6-56 
used to clear space within 
clipping rectangle, 2-10 
Scrolling 
by VT102 Emulator, F-3 
SD.GDS parameter 
use of, F-4, F-5 
Secondary color 
definition, G-5 
reset state, 6-39 
setting, 6-109 
Secondary color and NEW_PICTURE, 
6-45 
SET ALPHABET 
reference description, 6-58 


used to select current alphabet, 


2-22 
SET AREA CELL SIZE 
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reference description, 6-59 
used to clip area texture cell, 
2-17 
SET_AREA_TEXTURE 
effect on area cell size, 6-59 
reference description, 6-61 
size limitation in, 2-17 
used to set fill pattern, 2-16 
SET_AREA_TEXTURE_SIZE 
reference description, 6-63 
used to scale fill character, 
2-17 
SET_CELL_DISPLAY_SIZE 
reference description, 6-64 
SET_CELL_EXPLICIT MOVEMENT 
reference description, 6-67 
used in updating the current 
position, 2-17 
SET_CELL_MOVEMENT_MODE 
reference description, 6-69 
used in updating the current 
position, 2-17 
used to specify symmetry, 2-19 
SET_CELL_OBLIQUE 
reference description, 6-71 
used for changing the character 
cell shape, 2-20 
SET_CELL_RENDITION 
reference description, 6-73 
specifying, 2-20 
SET_CELL_ROTATION 
reference description, 6-75 
SET_CELL_UNIT_SIZE 
reference description, 6-76 
SET _COLOR_MAP_ENTRY 
reference description, 6-78 
SET_GIDIS_OUTPUT_SPACE 
function of, 2-8 
invalid in filled figure, 6-7 
reference description, 6-81 
used to display a part of a 
picture, 2-10 
used to scale pictures, 2-10 
SET_LINE_TEXTURE 
reterence description, 6-86 
with line and curve attributes, 
2-16 
SET _OUTPUT_BITMAP 
reference description, 6-88 
used to create up to four 
picture, 2=it 


SET_OUTPUT_ CLIPPING REGION 
function of, 2-8 
reference description, 6-89 
set by SET_OUTPUT_VIEWPORT, 
2-10 
uses of, 2-10 


_SET_OUTPUT_CURSOR 


reference description, 6-91 
used to select cursor, 2-10 
SET_OUTPUT_CURSOR_RENDITION 
reference description, 6-94 
specifies cursor/rubber band 
rendition, 2-10 
SET_OUTPUT_IDS 
invalid in filled figure, 6-7 
other functions performed by, 
2-8 
reference description, 6-95 
setting clipping rectangle with, 
2-8 
setting GIDIS Output Space 
(GOS) with, 2-8 
setting viewport with, 2-8 
used to set Imposed Device 
Space, 2-8 
SET_OUTPUT_RUBBER_BAND 
reference description, 6-98 
used to select rubberband, 2-10 
SET_OUTPUT_VIEWPORT 
function of, 2-8 
invalid in filled figure, 6-7 
reference description, 6-100 
used to specify size and 
location of viewport, 2-10 
SET PIXEL_SIZE, 2-16 
reference description, 6-102 
SET PLANE_MASK, 2-15 
and vVT102 Emulator, F-3 
reference description, 6-104 
SET POSITION 
invalid in filled figure, 6-7 
reference description, 6-106 
SET PRIMARY COLOR, 2-15 
reference description, 6-107 
SET _REL_POSITION 
invalid in filled figure, 6-7 
reference description, 6-108 
SET SECONDARY_COLOR, 2-15 
reference description, 6-109 
SET _WRITING_MODE, 2-15 
reference description, 6-111 
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Spacing between characters 
explanation of, 2-17 
~SPFUN 370 ; 
checking errors with, 5-11 
function of, 5-11 
Structure of, 5-11 
eSPFUN 371 
Checking errors with, 5-11 
function of, 5-11 
Structure of, 5-11 
~SPFUN programmed request 
with RT-11 MACRO-11 interface, 
5-10 
Standard display size 
definition, G-5 
Standard unit size 
definition, G-5 
Status 
in error condition, 3-3 
reporting, 6-54 
Stroke device 
definition, G-5 
Symmetry 
global 
definition, 2-19 
local 
definition, 2-19 
specifying with 
SET CELL MOVEMENT MODE, 
2-19 
Syntax errors 
how GIDIS handles, 3-3 
insufficient arguments, 3-3 
too many arguments, 3-3 
SYSLIB 
as source of QIO routine, F-1 
module QIOSYM, F-3 


TEK 4014 
relationship to PRO/GIDIS, 1-3 
Terminal emulation 
and ReGIS, 1-2 
Terminal emulator 
see VT100 mode emulator 
see VT102 Emulator 
see VT200 mode emulator 
Text attributes 
determining rendition of drawn 
characters, 2-13 
Function of, 2-17 
Text rendition 


I 
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definition, G-5 
Texture cell 
changing the size of, 2-17 


Unit cell 
definition, G-6 
reporting, 6-49 
Unit cell size 
definition of, 2-17 


View surface 
and NEW_PICTURE, 6-45 
definition, G-6 
Viewing transformation 
definition, G-6 
Viewport 
affected by SET_OUTPUT_IDS, 
6-97 
changing the location of, 2-8 
changing the size of, 2-8 
definition, G-6 
definition of, 2-3 
reset state, 6-39 
setting, 6-100 
VT100 mode emulator 
use of, 1-4 
use of planes, 6-104 
VT102 Emulator 
interaction with PRO/GIDIS, F-2, 
F-3 
use of with PRO/GIDIS, F-1 
vVT200 mode emulator 
use of, 1-4 


Window 
clipping of, 2-3 
definition, G-6 
definition of, 2-3 
window, G-6 
Write Special Data 
see IO.WSD 
Writing attributes 
and drawing characters, 2-14 
and drawing lines and arcs, 
2-14 
and filling figures, 2-14 
definition of, 2-14 
plane mask, 2-15 
pramary color, 2-15 
relationship to bit patterns, 
2-14 
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secondary color, 2-15 reset state, 6-39 
writing mode, 2-15 setting, 6-111 

Writing mode setting with SET_WRITING_MODE, 
default, 2-15 2-15 


function of, 2-15 
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